From 9fa47cbba2a5beff703603861cd163be0a70b100 Mon Sep 17 00:00:00 2001 From: Gauthier Date: Thu, 5 Dec 2024 23:03:41 +0100 Subject: [PATCH] docs: add a troubleshooting page (#1109) * docs: add a troubleshooting page This troubleshooting page explains how to solve dns blockage issues from ISPs and how to fix some slowdowns / ipv6 errors with the forceIpv4First environment variable. fix #1098 * fix: specify the difference between DNS blocking and total blocking from the ISP --- docs/troubleshooting.mdx | 158 +++++++++++++++++++++++++++++++++++++++ 1 file changed, 158 insertions(+) create mode 100644 docs/troubleshooting.mdx diff --git a/docs/troubleshooting.mdx b/docs/troubleshooting.mdx new file mode 100644 index 000000000..2f3fed66c --- /dev/null +++ b/docs/troubleshooting.mdx @@ -0,0 +1,158 @@ +--- +title: Troubleshooting +--- + +import Tabs from '@theme/Tabs'; +import TabItem from '@theme/TabItem'; + +## [TMDB] failed to retrieve/fetch XXX + +### Option 1: Change your DNS servers + +This error often comes from your Internet Service Provider (ISP) blocking TMDB API. The ISP may block the DNS resolution to the TMDB API hostname. + +To fix this, you can change your DNS servers to a public DNS service like Google's DNS or Cloudflare's DNS: + + + + +Add the following to your `docker run` command to use Google's DNS: +```bash +--dns=8.8.8.8 +``` +or for Cloudflare's DNS: +```bash +--dns=1.1.1.1 +``` + + + + + +Add the following to your `compose.yaml` to use Google's DNS: +```yaml +--- +services: + jellyseerr: + dns: + - 8.8.8.8 +``` +or for Cloudflare's DNS: +```yaml +--- +services: + jellyseerr: + dns: + - 1.1.1.1 +``` + + + + + +1. Open the Control Panel. +2. Click on Network and Internet. +3. Click on Network and Sharing Center. +4. Click on Change adapter settings. +5. Right-click the network interface connected to the internet and select Properties. +6. Select Internet Protocol Version 4 (TCP/IPv4) and click Properties. +7. Select Use the following DNS server addresses and enter `8.8.8.8` for Google's DNS or `1.1.1.1` for Cloudflare's DNS. + + + + + +1. Open a terminal. +2. Edit the `/etc/resolv.conf` file with your favorite text editor. +3. Add the following line to use Google's DNS: + ```bash + nameserver 8.8.8.8 + ``` + or for Cloudflare's DNS: + + ```bash + nameserver 1.1.1.1 + ``` + + + + +### Option 2: Force IPV4 resolution first + +Sometimes there are configuration issues with IPV6 that prevent the hostname resolution from working correctly. + +You can try to force the resolution to use IPV4 first by setting the `FORCE_IPV4_FIRST` environment variable to `true`: + + + + +Add the following to your `docker run` command: +```bash +-e "FORCE_IPV4_FIRST=true" +``` + + + + + +Add the following to your `compose.yaml`: +```yaml +--- +services: + jellyseerr: + environment: + - FORCE_IPV4_FIRST=true +``` + + + + +### Option 3: Use Jellyseerr through a proxy + +If you can't change your DNS servers or force IPV4 resolution, you can use Jellyseerr through a proxy. + +In some places (like China), the ISP blocks not only the DNS resolution but also the connection to the TMDB API. + +You can configure Jellyseerr to use a proxy with the [HTTP(S) Proxy](/using-jellyseerr/settings/general#https-proxy) setting. + +### Option 4: Check that your server can reach TMDB API + +Make sure that your server can reach the TMDB API by running the following command: + + + + +```bash +docker exec -it jellyseerr sh -c "apk update && apk add curl && curl -L https://api.themoviedb.org" +``` + + + + + +```bash +docker compose exec jellyseerr sh -c "apk update && apk add curl && curl -L https://api.themoviedb.org" +``` + + + + +In a terminal: +```bash +curl -L https://api.themoviedb.org +``` + + + + +In a PowerShell window: +```powershell +(Invoke-WebRequest -Uri "https://api.themoviedb.org" -Method Get).Content +``` + + + + + +If you can't get a response, then your server can't reach the TMDB API. +This is usually due to a network configuration issue or a firewall blocking the connection.