Troubleshooting

[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:

Docker CLI

Add the following to your docker run command to use Google's DNS:

--dns=8.8.8.8

or for Cloudflare's DNS:

--dns=1.1.1.1

or for Quad9 DNS:

--dns=9.9.9.9

You can try them all and see which one works for your network.

Docker Compose

Add the following to your compose.yaml to use Google's DNS:

---
services:
  jellyseerr:
    dns:
      - 8.8.8.8

or for Cloudflare's DNS:

---
services:
  jellyseerr:
    dns:
      - 1.1.1.1

or for Quad9's DNS:

---
services:
  jellyseerr:
    dns:
      - 9.9.9.9

You can try them all and see which one works for your network.

Windows

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 or 9.9.9.9 for Quad9's DNS.

Linux

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:

   nameserver 8.8.8.8

   or for Cloudflare's DNS:

   nameserver 1.1.1.1

   or for Quad9's DNS:

   nameserver 9.9.9.9

Option 2: 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 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:

Docker CLI

docker exec -it jellyseerr sh -c "apk update && apk add curl && curl -L https://api.themoviedb.org"

Docker Compose

docker compose exec jellyseerr sh -c "apk update && apk add curl && curl -L https://api.themoviedb.org"

Linux

In a terminal:

curl -L https://api.themoviedb.org

Windows

In a PowerShell window:

(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.

Account does not have admin privileges

If your admin account no longer has admin privileges, this is typically because your Jellyfin/Emby user ID has changed on the server side.

This can happen if you have a new installation of Jellyfin/Emby or if you have changed the user ID of your admin account.

Solution: Reset admin access

1. Back up your settings.json file (located in your Jellyseerr data directory)
2. Stop the Jellyseerr container/service
3. Delete the settings.json file
4. Start Jellyseerr again
5. This will force the setup page to appear
6. Go through the setup process with the same login details
7. You can skip the services setup
8. Once you reach the discover page, stop Jellyseerr
9. Restore your backed-up settings.json file
10. Start Jellyseerr again

This process should restore your admin privileges while preserving your settings.

If you still encounter issues, please reach out on our support channels.