Appearance
Streaming and Requests
Jellyfin serves the library, Seerr accepts requests, and Streamystats summarizes playback activity. Jellyfin and Seerr share a Compose project; Streamystats lives in the shared Servarr project.
Prepare the media server host first. The media deployment overview covers shared storage and the Servarr Compose project. Host-specific AI setup, private accounts, and recovery details are in the internal companion.
Access
| Service | Domain | Direct access |
|---|---|---|
| Jellyfin | jelly.home.rwk.me | http://10.120.40.105:8096 |
| Seerr | jellyseer.home.rwk.me | http://10.120.40.105:5055 |
| Streamystats | stats.home.rwk.me | http://10.120.40.105:3000 |
Deploy Jellyfin and Seerr
Run as your deployment account to prepare the project:
sh
sudo install -d -o "$(id -u)" -g "$(id -g)" -m 0750 /docker/jellyfin
cd /docker/jellyfinCreate compose.yaml:
yaml
services:
jellyfin:
image: lscr.io/linuxserver/jellyfin:12.4ubu2604-ls57
container_name: jellyfin
environment:
- PUID=${PUID}
- PGID=${PGID}
- TZ=${TZ}
- JELLYFIN_PublishedServerUrl=${JELLYFIN_PublishedServerUrl} # optional
- DOCKER_MODS=linuxserver/mods:jellyfin-opencl-intel # HDR/DV tone mapping
devices:
- /dev/dri:/dev/dri # Intel Quick Sync and VA-API
volumes:
- ./config:/config
- /mnt/unaspro/media:/data
ports:
- "${SERVER_IP}:8096:8096"
- "${SERVER_IP}:7359:7359/udp" # Client discovery remains available on the LAN
- "${SERVER_IP}:1900:1900/udp" # DLNA/SSDP remains available on the LAN
restart: unless-stopped
jellyseerr:
container_name: jellyseerr
image: ghcr.io/seerr-team/seerr:v3.5.1
init: true
environment:
- PUID=${PUID}
- PGID=${PGID}
- TZ=${TZ}
- LOG_LEVEL=debug
volumes:
- ./jellyseerr:/app/config
ports:
- "${SERVER_IP}:5055:5055"
restart: unless-stoppedCreate .env:
dotenv
SERVER_IP=10.120.40.105
PUID=1000
PGID=1000
TZ=America/Chicago
JELLYFIN_PublishedServerUrl=https://jelly.home.rwk.meUse your actual host address, UID/GID, timezone, and client-facing Jellyfin URL. The container name jellyseerr is retained for compatibility with the existing deployment even though the image is Seerr.
sh
mkdir -p config jellyseerr
chmod 600 .env
findmnt /mnt/unaspro/media
ls -l /dev/dri
docker compose config --quiet
docker compose pull
docker compose up -d
docker compose psFor local media storage, replace the NAS binding and skip the NAS check. The Intel configuration requires a real render device. For a CPU-only installation, remove the /dev/dri mapping and Intel Docker mod, and use software transcoding settings appropriate to your host.
The default Compose network lets Seerr reach Jellyfin by service name. UDP 7359 provides Jellyfin client discovery; UDP 1900 is available for SSDP/DLNA where configured in the application. Discovery does not automatically cross routed VLANs, and opening a UDP port does not install a DLNA plugin.
Configure Jellyfin
Open the direct endpoint for initial setup, choose a language, and create the administrator account. Add movie and television libraries using the shared container paths, such as /data/movies and /data/tv, not the host's /mnt/... paths. Configure metadata language, user access, and library scanning for your content. Store credentials in your password manager.
Intel hardware acceleration
Verify the detected device and driver inside the running container:
sh
docker exec jellyfin /usr/lib/jellyfin-ffmpeg/vainfo --display drm --device /dev/dri/renderD128In Dashboard → Playback → Transcoding, select Intel QuickSync (QSV) and /dev/dri/renderD128 for this host. Enable only decoding and encoding formats supported by your GPU. This lab's Meteor Lake GPU supports H.264, HEVC, and AV1 hardware encoding; another GPU may need fewer formats. Enable tone mapping when HDR-to-SDR conversion is required. The LinuxServer Intel OpenCL mod supplies the tone-mapping support configured here.
Force a transcode by selecting a lower playback quality. Check the active session and its FFmpeg log for a QSV codec such as h264_qsv or hevc_qsv. Direct play alone does not prove transcoding works. See Jellyfin's Intel guide when adapting to other hardware.
Trickplay previews
In Dashboard → Playback → Trickplay, this lab uses:
| Option | Value |
|---|---|
| Hardware decoding | Enabled |
| Hardware MJPEG encoding | Disabled |
| Keyframe-only extraction | Disabled |
| Scan behavior / priority | Non-blocking / below normal |
| Image interval / width | 10 seconds / 320 pixels |
| Tile grid | 10 × 10 |
| FFmpeg quality scale / JPEG quality | 4 / 90 |
| FFmpeg threads | 1 |
These are starting values for this GPU and workload, not universal requirements. Generate previews for a representative item and check playback responsiveness, output size, and scrub accuracy before processing the full library.
Additional Jellyfin plugins
These are the separately installed plugins used by this lab.
| Plugin | Purpose |
|---|---|
| Fanart | Additional posters and artwork for movies, series, and music artists |
| Intro Skipper | Detect intros, credits, recaps, and previews for playback skipping |
| Jellyfin Helper | Library inspection, orphaned trickplay cleanup, and configurable maintenance tasks |
| Neptune Indexers | Server-side library and search indexes for Neptune clients |
| Neptune MDM | Settings synchronization and administrative controls for Neptune clients |
| TheTVDB | Television metadata and identifiers from TheTVDB |
Install the plugin catalogs
In Dashboard → Plugins → Repositories, enable the official stable catalog and add the catalogs needed for these additional plugins:
| Catalog | Manifest URL | Plugins used here |
|---|---|---|
| Jellyfin Stable | https://repo.jellyfin.org/files/plugin/manifest.json | Fanart, TheTVDB |
| Intro Skipper | https://manifest.intro-skipper.org/manifest.json | Intro Skipper |
| Jellyfin Helper | https://raw.githubusercontent.com/JellyPlugins/jellyfin-helper/main/manifest.json | Jellyfin Helper |
| Neptune | https://plugins.neptuneplayer.com/manifest.json | Neptune Indexers, Neptune MDM |
Artwork and television metadata
After installing Fanart and TheTVDB, open each relevant library's settings and select the intended metadata and image providers. Choose their order deliberately and test a representative item before refreshing an entire library.
Intro Skipper
This lab enables intro detection and scanning for credits, recaps, and previews, caches fingerprints, and uses a maximum of two parallel analyses. It analyzes movies and the selected libraries, while season-zero analysis is disabled. Automatic skipping is disabled; compatible clients can offer the detected skip controls.
Open Dashboard → Scheduled Tasks to inspect the plugin's media-segment analysis task. Test detection on a representative episode and check skip behavior in the actual client before processing a large library. Detection can be resource-intensive, so coordinate it with transcoding, subtitle generation, and backups. See the Intro Skipper installation guide for release-specific setup.
Jellyfin Helper
This lab uses these task modes:
| Task | Mode |
|---|---|
| Orphaned trickplay cleanup | Active |
| Empty media folder cleanup | Dry run |
| Orphaned subtitle cleanup | Dry run |
| Link repair | Dry run |
| Seerr request cleanup | Disabled |
| Recommendations | Dry run |
The minimum orphan age is 30 days, and trash is disabled. See Jellyfin Helper for task settings and recovery controls.
Neptune clients
Install both Neptune plugins when using Neptune's server-side indexing and managed client settings. In this lab, Indexers automatically rebuilds after library changes with a 60-second debounce; artist enrichment, album resolution, album art, and IMVDb credits are enabled.
Configure MDM's intended server defaults and client settings through its plugin page, then reconnect a Neptune client and verify the expected library/search behavior and settings synchronization. See the Neptune plugin documentation for configuration details.
Plugin packages and configuration persist with Jellyfin's /config mount and should be included in its protected application-state backup. Use the internal plugin runbook for exact paths, runtime checks, and safe activation procedures.
Configure Seerr
Open Seerr and choose the Jellyfin setup path. Connect to http://jellyfin:8096 on the shared Compose network and authenticate with the account required by onboarding. Set the client-facing Jellyfin URL to the HTTPS hostname when that setting is available.
Add the two media-manager connections using the host's published endpoints:
| Manager | Address |
|---|---|
| Sonarr | http://10.120.40.105:8989 |
| Radarr | http://10.120.40.105:7878 |
Retrieve each manager's API key from its settings, test the connection, and select the intended root folder, quality profile, and default service. Seerr is in a separate Compose network, so the Servarr service names are not automatically resolvable from it. Configure user request permissions and approval rules deliberately. See the Seerr services guide for available options.
Test a request and confirm it appears in the correct manager without bypassing your intended approval policy.
Configure Streamystats
Deploy it through the shared Servarr configuration, including its three independent secrets. The all-in-one image includes PostgreSQL and background processing, and stores its database in the project's streamystats-data named Docker volume.
Open the dashboard, complete onboarding, and connect it to https://jelly.home.rwk.me. The container must resolve that hostname and reach the proxy. Set any required Jellyfin API credentials privately, then verify the connection and a representative playback session. Startup full sync is disabled in this lab to avoid rescanning after daily backup restarts; manually requested and scheduled synchronization remain available.
sh
cd /docker/servarr
docker compose ps streamystats
curl --fail --silent --show-error http://10.120.40.105:3000/api/healthBack up its database through a logical dump as described on the backup page; copying only /docker/servarr does not copy its named volume.
Configure DNS and HTTPS
These service names use this lab's Cloudflare-managed home.rwk.me DNS and resolve to Nginx Proxy Manager at 10.120.40.101. They require an allowed route through the homelab LAN or approved Tailscale access. This setup does not require WAN port forwarding for the service names.
Create the following proxy hosts, select the certificate covering each hostname, and force HTTPS:
| Domain | Backend | WebSockets |
|---|---|---|
jelly.home.rwk.me | http://10.120.40.105:8096 | Enabled |
jellyseer.home.rwk.me | http://10.120.40.105:5055 | Not required |
stats.home.rwk.me | http://10.120.40.105:3000 | Enabled |
For another homelab, use your domain, proxy address, certificates, and access policy. See Nginx Proxy Manager for DNS-only records and certificate setup. A proxy access list does not restrict direct backend connections; network and application controls still apply.
Maintenance and recovery
Check direct playback, forced hardware transcode, library visibility, a Seerr request, and Streamystats history after maintenance. Protect Jellyfin config, Seerr jellyseerr, and the Streamystats database dump with their matching configuration. Use the coordinated backup workflow before image changes, and restore application-compatible database versions rather than blindly downgrading images.
The private homelab source directory retains Compose files, environment templates, and executable assets. This guide explains setup; the internal companion provides exact AI operating procedures. Keep the image pins and these examples aligned with reviewed source changes. Preserve existing state and a tested recovery point before updates, and repeat application checks afterward.