Files
docker-compose-cookbooks/jellyseerr_dev/README.md
T
nick cd70772880 refactor: rewrite jellyseerr_dev to match template conventions
- Rename docker-compose.yml to compose.yaml
- Add defaults, restart policy, and proxy network
- Remove container_name (unnecessary), TZ (not required)
- Fix VOL_PATH to use base /data pattern
- Rewrite README with new section order
2026-07-02 21:27:50 -07:00

2.2 KiB

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 your media server — select Jellyfin or Emby, enter server URL and API key
  3. Connect Sonarr and Radarr — Jellyseerr needs these to handle requests
  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)
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 \
  -p 5055:5055 \
  -v ${VOL_PATH:-/data}/jellyseerr/config:/config \
  --network proxy \
  --restart unless-stopped \
  ghcr.io/hotio/jellyseerr:release

Dockhand Stack, Deploy from Git

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

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