yams.media/content/advanced/vpn.md

title, date, draft, weight, summary

title	date	draft	weight	summary
VPN	2023-01-15T21:16:29-03:00	false	1	Advanced configuration for the VPN, supported VPN lists and manual configuration.

Remember: You should always use a VPN when downloading torrents!.

YAMS uses gluetun for VPN.

Official supported VPNs

• AirVPN
• Cyberghost
• ExpressVPN
• FastestVPN
• Hidemyass
• IPVanish
• IVPN
• Mullvad (Recommended!)
• NordVPN
• Perfect privacy
• Privado
• Private internet access
• PrivateVPN
• ProtonVPN
• PureVPN
• SlickVPN
• Surfshark
• Torguard
• VPN Secure
• VPN Unlimited
• VyprVPN
• WeVPN
• Windscribe

You can also set a custom VPN provider, but this is not officially supported for YAMS. You are on your own here.

Manual configuration

To manually configure your VPN, you have to edit your docker-compose.yaml file.

First, stop YAMS:

$ yams stop

Then, open your docker-compose.yaml file. For this tutorial, I'm assuming the install location is /opt/yams. Also, you don't have to use vim, you can use nano or any other editor.

$ vim /opt/yams/docker-compose.yaml

On the file, find the qbitorrent config and make the following changes:

...
    # ports: # qbittorrent -> Comment this line
    #  - 8080:8080 # qbittorrent -> Comment this line
    network_mode: "service:gluetun" -> Uncomment this line

Then, at the bottom, find the gluetun config and make the following changes:

...
      - 8080:8080/tcp # gluetun -> Uncomment this line
...
    environment:
      - VPN_SERVICE_PROVIDER=<vpn_service> # -> Replace "<vpn_service>" with your VPN service provider
      - VPN_TYPE=openvpn
      - OPENVPN_USER=<vpn_user> # -> Replace "<vpn_user>" with your VPN username
      - OPENVPN_PASSWORD=<vpn_password> # -> Replace "<vpn_password>" with your VPN password
      - SERVER_COUNTRIES=<vpn_country> # -> Replacee "<vpn_country>" with your VPN country

Now, restart YAMS:

$ yams restart

Finally, check that your VPN is running correctly:

$ yams check-vpn

Getting your qBittorrent IP...
<your_qbittorrent_ip>
Your country in qBittorrent is Brazil

Getting your IP...
<your_local_ip>
Your local IP country is North Korea

Your IPs are different. qBittorrent is working as expected! ✅

If it's not running correctly, check every setting and make sure they are all correct.

Double check your torrent client IP address

Go here.