Files
docker-compose-cookbooks/jellyseerr
2026-11-07 07:19:44 +00:00
..
2026-11-07 07:19:44 +00:00
2026-11-07 07:19:44 +00:00

Jellyseerr

Overview

Jellyseerr is a free and open-source request management system for your Jellyfin/Emby media library, forked from Overseerr. It lets users browse, discover, and request movies and TV shows. Approved requests are sent to Sonarr/Radarr for automatic downloading.

Project Details

Getting Started

Open http://localhost:5055 in your browser and complete the initial setup:

  1. Create your admin account

  2. Connect Jellyfin — sign in with your Jellyfin admin account. Server URL: http://jellyfin:8096 (container name on the proxy network). Then pick which libraries to sync (Movies, Shows)

  3. Connect Radarr and Sonarr — get each API key from Settings → General in the app:

    Radarr Sonarr
    Hostname radarr sonarr
    Port 7878 8989
    Root Folder /media/movies /media/shows
    Quality Profile pick one pick one

    Tick Default Server on each, click Test, then Save

  4. Users can now browse your library and submit requests via the Jellyseerr UI

Request flow

User submits a request → approved (auto or manual) → Jellyseerr sends it to Sonarr/Radarr → download client grabs it → media appears in Jellyfin

Environment Variable Notes

Variable Description
JELLYSEERR_IMAGE Container image (default: ghcr.io/hotio/jellyseerr:release)
JELLYSEERR_RESTART Restart policy (default: unless-stopped)
JELLYSEERR_PORT Published port for the web UI (default: 5055)
TZ Container timezone (default: America/Vancouver)
VOL_PATH Base path for persistent data volumes (default: /data)

Volume Notes

Volume Purpose
${VOL_PATH:-/data}/jellyseerr/config Application configuration and database

Network Notes

Requires an external proxy network. Create it once with:

docker network create proxy

Docker Run

docker run -d \
  --name=jellyseerr \
  -e PUID=1000 \
  -e PGID=1000 \
  -e UMASK=002 \
  -e TZ=America/Vancouver \
  -p 5055:5055 \
  -v ${VOL_PATH:-/data}/jellyseerr/config:/config \
  --network proxy \
  --restart unless-stopped \
  ghcr.io/hotio/jellyseerr:release

Additional Notes / Gotchas

  • Jellyseerr doesn't mount any media. It only talks to Jellyfin, Sonarr and Radarr over their APIs, so it needs just /config.
  • The root folders entered here are paths inside the Sonarr/Radarr containers (/media/shows, /media/movies), not host paths.
  • Use container names (jellyfin, sonarr, radarr), not localhost. Inside the container, localhost is Jellyseerr itself.

Dockhand Stack, Deploy from Git

  • Cookbooks Repository
  • stackname: jellyseerr
  • Compose file path: jellyseerr/compose.yaml
  • Additional env file (optional): jellyseerr/sample.env

Load jellyseerr/sample.env into the Environment variables in Dockhand, then create the Stack.