mirror of
https://github.com/nickyeoman/docker-compose-cookbooks.git
synced 2026-11-12 11:08:49 +00:00
codeandClaude Opus 5.5
7ed139d134
- Promote sonarr, radarr, jellyfin, jellyseerr from _dev - qBittorrent, Sonarr, Radarr, Lidarr, Readarr, Whisparr mount /data/media at /media so paths match across containers (no remote path mappings, hardlinks work); downloads go to /media/downloads/prowlarr - Jellyfin: drop photos (use Immich) and unused internal network, rewrite README - Jellyseerr: add TZ, document container hostnames and root folders Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
89 lines
3.1 KiB
Markdown
89 lines
3.1 KiB
Markdown
# 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
|
|
|
|
- **Project Repository:** [https://docs.jellyseerr.dev/](https://docs.jellyseerr.dev/)
|
|
- **Container Image:** [ghcr.io/hotio/jellyseerr](https://hotio.dev/containers/jellyseerr/)
|
|
- **Reverse Proxy Port:** `5055`
|
|
|
|
## 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:
|
|
|
|
```bash
|
|
docker network create proxy
|
|
```
|
|
|
|
## Docker Run
|
|
|
|
```bash
|
|
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.
|