Logo

Advanced

Port Forwarding

Port forwarding helps you get better download speeds by allowing incoming connections to your torrent client. YAMS enables port forwarding by default, but setup varies by VPN provider.

ProtonVPN Users 🚀

ProtonVPN makes port forwarding easy! Just follow these steps:

  1. Create a script to update qBittorrent’s port. Make sure you change /your/install/location:
mkdir -p /your/install/location/scripts
nano /your/install/location/scripts/update-port.sh
  1. Add this code to the script: https://gitlab.com/-/snippets/4788387. Make sure you edit this to match your own configuration:
QBITTORRENT_USER=admin            # qbittorrent username
QBITTORRENT_PASS=adminadmin       # qbittorrent password
  1. Make the script executable:
chmod +x /your/install/location/scripts/update-port.sh
  1. Run it to verify it’s working:
./your/install/location/scripts/update-port.sh

You should see an output similar to this:

2024-12-30 08:21:58 | VPN container gluetun in healthy state!
2024-12-30 08:21:58 | qBittorrent Cookie invalid, getting new SessionID
2024-12-30 08:21:58 | Public IP: 111.111.111.111
2024-12-30 08:21:58 | Configured Port: 61009
2024-12-30 08:21:58 | Active Port: 61009
2024-12-30 08:21:58 | Port OK (Act: 61009 Cfg: 61009)
  1. Set up automatic port updates (runs every 5 minutes):
(crontab -l 2>/dev/null; echo "*/5 * * * * /your/install/location/scripts/update-port.sh") | crontab -

Other VPN Providers 🌐

For other VPN providers, port forwarding configuration varies.

For detailed provider-specific instructions, check the Gluetun Port Forwarding Documentation.

Verifying Port Forwarding ✅

To check if port forwarding is working:

  1. Run curl http://localhost:8003/v1/openvpn/portforwarded to see your current port
  2. Visit Open Port Check Tool and test your port by using your public VPN IP and the active port
  3. Check qBittorrent’s connection status - it should show “Connection Status: Connected”

conection-status

Troubleshooting 🔧

  1. No port shown:

    docker logs gluetun | grep "\[port forwarding\]"

    Look for any error messages

  2. Port not updating:

    • Check if the script has execute permissions
    • Verify crontab is running: crontab -l
    • Check script logs: tail -f /var/log/syslog | grep update-port

Need help? Visit our Common Issues page or join our Discord or Matrix chat!