Installation

This guide shows you how to install Jellyfin via Docker Compose. Make sure Docker Engine is already installed on your system.

Prerequisites

Docker Engine installed (follow the official guide linked above)
Docker Compose available
Linux host system

1. Create a project directory

mkdir jellyfin
cd jellyfin

2. Create `docker-compose.yml`

version: "3"
services:
  jellyfin:
    image: jellyfin/jellyfin
    container_name: jellyfin
    user: uid:gid           # replace uid:gid with your actual user ID and group ID
    network_mode: "host"    # optional: needed for DLNA and certain integrations
    volumes:
      - ./config:/config
      - ./cache:/cache
      - /path/to/media:/media
        # Add more media folders if needed
    restart: unless-stopped
    environment:
      - JELLYFIN_PublishedServerUrl=http://your-domain-or-ip
    extra_hosts:
      - "host.docker.internal:host-gateway"

3. Start Jellyfin

docker compose up -d

4. Access Jellyfin

Open a browser and navigate to http://<your-host-ip>:8096 to begin setup via the web UI.

5. (Optional) Manage updates

When a new version is available:

docker compose pull
docker compose up -d

Notes

Ensure user ID (uid) and group ID (gid) match your Linux user to prevent permissions issues.
Host network mode is required for DLNA and some integrations only; you can remove it if not needed.
This setup uses bind-mounted folders (./config, ./cache, /path/to/media) for persistent data.

References

Official Docker installation guide: https://docs.docker.com/engine/install/
Jellyfin Docker Compose instructions

1.7 KiB Raw Blame History