Merge branch 'master' of gitlab.com:rogs/yams.media into v3

This commit is contained in:
Roger Gonzalez 2024-12-23 09:41:37 -03:00
commit c6bc8ffb1a
Signed by: rogs
GPG Key ID: C7ECE9C6C36EC2E6
11 changed files with 81 additions and 29 deletions

View File

@ -30,4 +30,3 @@ Your files will be on the `./public` folder, ready to upload to a server.
## todo
- Add dark mode
- Add a hotlink to the install.sh in the instructions.

View File

@ -64,7 +64,7 @@ summaryLength = 30
[[menu.main]]
name = "Matrix"
url = "https://matrix.to/#/#yams-space:chat.rogs.me"
url = "https://matrix.to/#/#yams-space:rogs.me"
weight = 99
[[menu.main]]

View File

@ -0,0 +1,63 @@
---
title: "Running Prowlarr behind the VPN"
date: 2024-09-27T16:44:00-03:00
draft: false
weight: 3
summary: How to put Prowlarr behind the VPN just like qBitTorrent
---
While not usually illegal, downloading .torrent files can be a grey area in a lot of places. Because of this, some ISPs will attempt to block indexers.
An obvious way around this is by putting Prowlarr itself behind the VPN. Here's the steps to do that
## Modifying Prowlarr
- Open your `docker-compose.yaml` file in your text editor of choice
- Scroll down to the `prowlarr` service and remove the `ports` section
- Add a new line: `network_mode: "service:gluetun"` (if you've renamed your Gluetun service, be sure to match the service names here)
- Under the existing `environment` section, add this line `- WEBUI_PORT=9696`
- Once finished, your Prowlarr service should look something like this
```yaml
prowlarr:
image: lscr.io/linuxserver/prowlarr
container_name: prowlarr
network_mode: "service:gluetun"
environment:
- PUID=${PUID}
- PGID=${PGID}
- WEBUI_PORT=9696
volumes:
- ${INSTALL_DIRECTORY}/config/prowlarr:/config
restart: unless-stopped
```
## Modifying Gluetun
- Scroll down to the `gluetun` section
- Under the `ports` section, add this line `- 9696:9696/tcp`
- Under the `environment` section, add this line: `- FIREWALL_OUTBOUND_SUBNETS=192.168.1.0/24` (NOTE: You'll want the subnet to match the subnet for your containers)
- If you're unsure what subnets your containers are running under, open up Portainer, click on `Containers`, and look in the `IP Address` column
- You really only need to care about the first two sections of the IP address. So if your containers are running under `172.18.X.X` then your entry would look like: `- FIREWALL_OUTBOUND_SUBNETS=172.18.1.0/24`
- Once finished, your Gluetun service should look something like this:
```yaml
gluetun:
image: qmcgaw/gluetun:v3
container_name: gluetun
cap_add:
- NET_ADMIN
devices:
- /dev/net/tun:/dev/net/tun
ports:
- 8888:8888/tcp # HTTP proxy
- 8388:8388/tcp # Shadowsocks
- 8388:8388/udp # Shadowsocks
- 8080:8080/tcp # gluetun
- 9696:9696/tcp
volumes:
- ${INSTALL_DIRECTORY}/config/gluetun:/config
environment:
- FIREWALL_OUTBOUND_SUBNETS=192.168.1.0/24 # NOTE: May look different on your system. Double check the subnets in Portainer
restart: unless-stopped`
```
Once all of your changes have been made, save and close the file
In your terminal, run `yams restart` to bounce the stack and apply your changes

View File

@ -36,7 +36,7 @@ YAMS uses [gluetun](https://github.com/qdm12/gluetun) for VPN.
- [WeVPN](https://github.com/qdm12/gluetun-wiki/blob/main/setup/providers/wevpn.md)
- [Windscribe](https://github.com/qdm12/gluetun-wiki/blob/main/setup/providers/windscribe.md)
You can also set up a [custom VPN provider](https://github.com/qdm12/gluetun-wiki/blob/main/setup/providers/Custom-provider), but **this is not officially supported for YAMS. You are on your own here.**
You can also set up a [custom VPN provider](https://github.com/qdm12/gluetun-wiki/blob/main/setup/providers/custom.md), but **this is not officially supported for YAMS. You are on your own here.**
## Manual configuration

View File

@ -7,9 +7,8 @@ weight: 100
## YAMS Official Chats
- Discord: [https://discord.gg/cpnAm2Mu](https://discord.gg/cpnAm2Mu).
- Matrix: [https://matrix.to/#/#yams-space:chat.rogs.me](https://matrix.to/#/#yams-space:chat.rogs.me).
- IRC: [libera.chat: #yams-chat IRC channel](ircs://irc.libera.chat/#yams-chat)
- Matrix: [https://matrix.to/#/#yams-space:rogs.me](https://matrix.to/#/#yams-space:rogs.me).
- Discord: [https://discord.gg/Gwae3tNMST](https://discord.gg/Gwae3tNMST).
## Also, YAMS has a forum now!

View File

@ -15,7 +15,7 @@ Because. That's why it's _**opinionated**_, you don't _necessarily_ have to agre
## I want to use YAMS in Windows. Can I do that?
You might have success running YAMS manually in Windows with `docker`, but I recommend you check out [WIMPS](https://github.com/Xaque8787/WIMPS), a YAMS inspired setup for Windows. According to its developer [/u/zachfive87](https://www.reddit.com/user/zachfive87/), "WIMPS isn't a finished project and is very rough around the edges" but you'll might have more success running WIMPS in Windows.
You might have success running YAMS manually in Windows with `docker`, but I recommend you check out [WIMPS](https://github.com/Xaque8787/WIMPS), a YAMS inspired setup for Windows. Although the project has been archived, it could provide a better starting point than YAMS.
## YAMS's configuration is too basic. I want more!

View File

@ -42,4 +42,4 @@ This command will display the last 100 lines of the Gluetun logs.
Many of the issues arise due to misconfigurations in your VPN setup. Please review the documentation for your VPN by clicking [here](/advanced/vpn).
Review the logs to try and find a solution. If you require assistance, feel free to join our Matrix chat and ask for help!
Review the logs to try and find a solution. If you require assistance, feel free to join our [Matrix](https://matrix.to/#/#yams-space:rogs.me) or [Discord](https://discord.gg/Gwae3tNMST) chat and ask for help!

View File

@ -55,7 +55,7 @@ If you can run `docker run hello-world` without `sudo`, you can continue. If you
### Inspecting the `install` script by yourself (optional).
Its always a good practice to verify and study the scripts you run on your machine. You can always inspect `install.sh` on the Gitlab repo here: https://gitlab.com/rogs/yams/-/blob/master/docs.org. You don't have to be a complete expert in `bash` (I'm definitely not lol), but if you have any experience with the Linux terminal you should be able to at understand what's happening.
Its always a good practice to verify and study the scripts you run on your machine. You can always inspect [`install.sh`](https://gitlab.com/rogs/yams/-/blob/master/install.sh?ref_type=heads) script in the Gitlab repo here: https://gitlab.com/rogs/yams/-/blob/master/docs.org. You don't have to be a complete expert in `bash` (I'm definitely not lol), but if you have any experience with the Linux terminal you should be able to at least understand what's happening.
### Cloning from Gitlab

View File

@ -3,18 +3,18 @@ title: "Upgrading YAMS from version 1 to version 2 (Advanced)"
date: 2023-10-25T19:19:19-03:00
draft: false
weight: 4
summary: Are you running YAMS v1? Here's the guide to upgrade YAMS to v2!
summary: Are you running YAMS V1? Here's the guide to upgrade YAMS to V2!
---
# First, a brief disclaimer
I want to make this very clear: **This is entirely optional!** I will continue to support YAMS v1 as well as YAMS v2.
I want to make this very clear: **This is entirely optional!** I will continue to support YAMS V1 as well as YAMS V2.
If you are completely happy with YAMS v1, or have a heavily modified setup, you can skip this tutorial!
If you are completely happy with YAMS V1, or have a heavily modified setup, you can skip this tutorial!
## What are the advantages?
- YAMS v2 introduces a new command: `yams upgrade`. It allows YAMS to upgrade itself.
- YAMS V2 introduces a new command: `yams update`. It allows YAMS to update itself.
- Adding custom containers is now easier. You can find the tutorial here: [Add your own containers](/advanced/add-your-own-containers/).
# Before starting
@ -34,7 +34,7 @@ cd ~/yams_upgrade
## Setup .env.example
Begin by opening the `.env.example` file. Add your correct information to the file. All this information is currently available in your YAMS v1 `docker-compose.yaml` file.
Begin by opening the `.env.example` file. Add your correct information to the file. All this information is currently available in your YAMS V1 `docker-compose.yaml` file.
For the purposes of this tutorial:
@ -76,7 +76,7 @@ sed -i -e "s|<filename>|/opt/yams/docker-compose.yaml|g" yams
# ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ REPLACE THE FIRST LINE HERE BETWEEN THE "|"
sed -i -e "s|<custom_file_filename>|/opt/yams/docker-compose.custom.yaml|g" yams
# ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ REPLACE THE SECOND LINE HERE BETWEEN THE "|"
sed -i -e "s|<install_DIRECTORY>|/opt/yams|g" yams
sed -i -e "s|<install_directory>|/opt/yams|g" yams
# ^^^^^^^^^ REPLACE THE THIRD LINE HERE BETWEEN THE "|"
```
@ -84,7 +84,7 @@ sed -i -e "s|<install_DIRECTORY>|/opt/yams|g" yams
Move your custom containers to `docker-compose.custom.yaml`. If you need help, you can use this tutorial from the "Adding a container" section: [Add your own containers - Adding a container](/advanced/add-your-own-containers/#adding-a-container).
# Finish the upgrade
# Finish the update
First, you need to stop YAMS. Run:
@ -127,7 +127,7 @@ cp $(which yams) yams-old
sudo cp yams $(which yams)
```
### Run the upgrade!
### Run the update!
Now it's the time to execute the update!
@ -139,6 +139,6 @@ Everything should be up and running!
# That's done!
YAMS should start back up again, and everything should be working as expected with the difference that now YAMS can be upgraded by using `yams upgrade`.
YAMS should start back up again, and everything should be working as expected with the difference that now YAMS can be updated by using `yams update`.
If you have any issues upgrading from v1 to v2, you can create a new post in our forum: [YAMS Forum: Upgrading YAMS from v1 to v2](https://forum.yams.media/viewforum.php?f=26)
If you have any issues upgrading from V1 to V2, you can create a new post in our forum: [YAMS Forum: Upgrading YAMS from V1 to V2](https://forum.yams.media/viewforum.php?f=26)

View File

@ -14,7 +14,7 @@
<img src="/pics/discord-small.png"/> <a href="https://discord.gg/Gwae3tNMST">Discord</a>
</li>
<li class="zerostatic">
<img src="/pics/element-small.png"/> <a href="https://matrix.to/#/#yams:chat.rogs.me">#yams:chat.rogs.me</a>
<img src="/pics/element-small.png"/> <a href="https://matrix.to/#/#yams-space:rogs.me">#yams-space:rogs.me</a>
</li>
{{ if not (in (.Site.BaseURL | string) "localhost") }}
<li class="zerostatic">

View File

@ -9,13 +9,8 @@
{{ block "meta_tags" . }}{{end}}
<link rel="icon" href="{{ "favicon.ico" | absURL}}">
{{ if .Site.IsServer }}
{{ $style := resources.Get "scss/style.scss" | toCSS (dict "targetPath" "css/style.css" "enableSourceMap" true) }}
<link rel="stylesheet" href="{{ ($style).RelPermalink }}">
{{ else }}
{{ $style := resources.Get "scss/style.scss" | toCSS (dict "targetPath" "css/style.css" "enableSourceMap" false) }}
<link rel="stylesheet" href="{{ ($style | minify | fingerprint).RelPermalink }}">
{{ end }}
{{ block "header_css" . }}{{ end }}
@ -60,11 +55,7 @@
{{ block "footer_js" . }}
{{ end }}
{{ if .Site.IsServer }}
<script type="text/javascript" src="{{ $scripts.RelPermalink }}"></script>
{{ else }}
<script type="text/javascript" src="{{ ($scripts | minify | fingerprint).RelPermalink }}"></script>
{{ end }}
</body>