Network

Network FAQ

Are you experiecing a lot of errors? "A lot" means you can no longer watch any content in your library. "A lot" means newly added content is not being added. If you are not experiencing this, then consider the errors just the occassional network issues that will resolve itself. If you really are experiencing degraded performance then check the different methods on this page to gather more info.

1. Check if Real-Debrid is blocking you

   • Go to this page in Real-Debrid
   • If you are NOT blocked, you'll see a panel with text "Your current IP address is not blocked on our website, you don't seem behind a VPN. Your ISP seems to be XYZ"

2. Run a Real-Debrid Speedtest

   This is a "sanity test" to see if you are able to download files from Real-Debrid download servers.

   • Go to the Speedtest page
   • Run it and see the results

3. Make sure "Use my Remote Traffic automatically when needed" is unchecked

   • Go to your account page
   • Under "Account Settings", uncheck "Use my Remote Traffic automatically when needed"

4. Run zurg network test and use "preferred_hosts"

   Note: This works on Mac and Linux only

   • Run ./zurg network-test
   • It checks latency on ALL KNOWN download servers of Real-Debrid
   • Watch out for errors on the output
   • Copy the final output for the setting preferred_hosts and paste it in your config.yml
   • Restart zurg

5. Using IPv6 with "preferred_hosts" method

   Note: This works on Mac and Linux only

   • Run ./zurg network-test -t ipv6
   • It checks latency on ALL KNOWN IPv6 download servers of Real-Debrid
   • Watch out for errors on the output
   • Copy the final output for the setting preferred_hosts and paste it in your config.yml
   • Set force_ipv6 to true and save your changes in config.yml
   • Restart zurg

6. Using IPv6 with Real-Debrid "Cloudflare" method

   • Go to your account page
   • Under "Account Settings", you'll see "CDN Servers Selection [?] [?]" and click the second "[?]"
   • You'll be redirected to the Speedtest page. Run and wait for it to finish.
   • Close the tab after it finishes and go back to the account page tab.
   • Select Cloudflare from Automatic (N/A) Cloudflare Disabled
   • Set force_ipv6 to true and save your changes in config.yml
   • Restart zurg

7. Is another IP address using your account?

   Remember that only 1 IP Address can use your account.

   • Check your Downloads page see if there are any IP addresses there that is downloading from your account
   • Run ./zurg clear-downloads to remove all your existing unrestricted links (this won't affect your library)
   • Go to Devices page and delete all of the entries there
   • Change your account password: Go to account page and click "Change" on "Password"
   • Change your API key: Go to API token page and click "Refresh"
   • Don't forget to update zurg's config.yml with your new token
   • Restart zurg
   • Relogin on Real-Debrid

8. Use a previous version of zurg and see if the problem persists

   • Try zurg version v0.9.2-hotfix.4
   • Hard code the version in your docker-compose.yml and run docker compose down && docker compose up -d
   • If you're using the binary, just replace the binary file with one of these previously released versions