Skip to content

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 ​

ServiceDomainDirect access
Jellyfinjelly.home.rwk.mehttp://10.120.40.105:8096
Seerrjellyseer.home.rwk.mehttp://10.120.40.105:5055
Streamystatsstats.home.rwk.mehttp://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/jellyfin

Create 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-stopped

Create .env:

dotenv
SERVER_IP=10.120.40.105
PUID=1000
PGID=1000
TZ=America/Chicago
JELLYFIN_PublishedServerUrl=https://jelly.home.rwk.me

Use 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 ps

For 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/renderD128

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

OptionValue
Hardware decodingEnabled
Hardware MJPEG encodingDisabled
Keyframe-only extractionDisabled
Scan behavior / priorityNon-blocking / below normal
Image interval / width10 seconds / 320 pixels
Tile grid10 × 10
FFmpeg quality scale / JPEG quality4 / 90
FFmpeg threads1

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.

PluginPurpose
FanartAdditional posters and artwork for movies, series, and music artists
Intro SkipperDetect intros, credits, recaps, and previews for playback skipping
Jellyfin HelperLibrary inspection, orphaned trickplay cleanup, and configurable maintenance tasks
Neptune IndexersServer-side library and search indexes for Neptune clients
Neptune MDMSettings synchronization and administrative controls for Neptune clients
TheTVDBTelevision 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:

CatalogManifest URLPlugins used here
Jellyfin Stablehttps://repo.jellyfin.org/files/plugin/manifest.jsonFanart, TheTVDB
Intro Skipperhttps://manifest.intro-skipper.org/manifest.jsonIntro Skipper
Jellyfin Helperhttps://raw.githubusercontent.com/JellyPlugins/jellyfin-helper/main/manifest.jsonJellyfin Helper
Neptunehttps://plugins.neptuneplayer.com/manifest.jsonNeptune 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:

TaskMode
Orphaned trickplay cleanupActive
Empty media folder cleanupDry run
Orphaned subtitle cleanupDry run
Link repairDry run
Seerr request cleanupDisabled
RecommendationsDry 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:

ManagerAddress
Sonarrhttp://10.120.40.105:8989
Radarrhttp://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/health

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

DomainBackendWebSockets
jelly.home.rwk.mehttp://10.120.40.105:8096Enabled
jellyseer.home.rwk.mehttp://10.120.40.105:5055Not required
stats.home.rwk.mehttp://10.120.40.105:3000Enabled

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.