# Jellyfin •

[Jellyfin](https://jellyfin.org) is a community-built media streaming solution for movies, music, television, books and photos. When you import media, it is automatically identified so metadata can be pulled from open repositories. Watch your media on all your devices with client apps made for every platform.

# Overview

[![Screen Shot 2025-03-08 at 15.28.05.png](https://hub.subspace.services/uploads/images/gallery/2025-03/scaled-1680-/screen-shot-2025-03-08-at-15-28-05.png)](https://hub.subspace.services/uploads/images/gallery/2025-03/screen-shot-2025-03-08-at-15-28-05.png)

[Jellyfin](https://jellyfin.org) is a community-built media streaming solution for movies, music, television, books and photos. When you import media, it is automatically identified so metadata can be pulled from open repositories. Watch your media on all your devices with client apps made for every platform.

<p class="callout success">Tryout a [Jellyfin demo](https://demo.jellyfin.org/stable/web/).</p>

- Access a home dashboard that lets you keep track of new releases, current progress and what's up next.
- Share your media with friends and sync your playback in real-time to watch together.
- Automatically converts media to a compatible format for your streaming device.

# Media

## Screenshots

<p class="callout info">Jellyfin Server v10.10.3</p>

<table border="1" id="bkmrk-" style="border-collapse: collapse; width: 100%; border-width: 1px; height: 59.6px; border-color: rgb(88, 110, 117);"><colgroup><col style="width: 33.3333%;"></col><col style="width: 33.3333%;"></col><col style="width: 33.3333%;"></col></colgroup><tbody><tr style="height: 29.8px;"><td style="border-width: 1px; height: 29.8px; border-color: rgb(88, 110, 117);">[![Screen Shot 2025-03-08 at 15.28.05.png](https://hub.subspace.services/uploads/images/gallery/2025-03/scaled-1680-/screen-shot-2025-03-08-at-15-28-05.png)](https://hub.subspace.services/uploads/images/gallery/2025-03/screen-shot-2025-03-08-at-15-28-05.png)</td><td style="border-width: 1px; height: 29.8px; border-color: rgb(88, 110, 117);">[![Screen Shot 2025-03-08 at 15.28.30.png](https://hub.subspace.services/uploads/images/gallery/2025-03/scaled-1680-/screen-shot-2025-03-08-at-15-28-30.png)](https://hub.subspace.services/uploads/images/gallery/2025-03/screen-shot-2025-03-08-at-15-28-30.png)</td><td style="border-width: 1px; height: 29.8px; border-color: rgb(88, 110, 117);">[![Screen Shot 2025-03-08 at 15.28.38.png](https://hub.subspace.services/uploads/images/gallery/2025-03/scaled-1680-/screen-shot-2025-03-08-at-15-28-38.png)](https://hub.subspace.services/uploads/images/gallery/2025-03/screen-shot-2025-03-08-at-15-28-38.png)</td></tr><tr style="height: 29.8px;"><td style="border-width: 1px; height: 29.8px; border-color: rgb(88, 110, 117);">[![Screen Shot 2025-03-08 at 15.29.01.png](https://hub.subspace.services/uploads/images/gallery/2025-03/scaled-1680-/screen-shot-2025-03-08-at-15-29-01.png)](https://hub.subspace.services/uploads/images/gallery/2025-03/screen-shot-2025-03-08-at-15-29-01.png)</td><td style="border-width: 1px; height: 29.8px; border-color: rgb(88, 110, 117);">  
</td><td style="border-width: 1px; height: 29.8px; border-color: rgb(88, 110, 117);">  
</td></tr></tbody></table>

# Setup & Configuration

We need to install the service through Portainer and configure any necessary settings.

# Preparation

There are some things we need to do in preparation to install this service.

## Volumes

<details id="bkmrk-media-folders-radarr"><summary>Persistent Data</summary>

This is where the service will store its own application data and ensures we can quickly update the service image.

<p class="callout warning">Ensure your user has permissions to access the folder.</p>

</details><details id="bkmrk-media-folders-this-s"><summary>Media Folders</summary>

This service will need access to the folders where you store your media files.

<p class="callout warning">Ensure your user has permissions to access the folder.</p>

</details>## Environment

<details id="bkmrk-tz-this-is-the-curre"><summary>TZ</summary>

This is the current time zone formatted using the [tz database.](https://en.wikipedia.org/wiki/List_of_tz_database_time_zones)

<p class="callout info">*For example:* America/Vancouver</p>

</details><details id="bkmrk-gid-%C2%A0"><summary>PUID</summary>

This is the numeric ID of the user account on Debian. If you are unsure, open a terminal and run:

```bash
id -u
```

</details><details id="bkmrk-pgid-this-is-the-num"><summary>PGID</summary>

This is the numeric ID of the user account's group on Debian. If you are unsure, open a terminal and run:

```bash
id -g
```

</details>### Hardware Acceleration

<p class="callout warning">You will need to [perform additional steps to attach some graphics cards](https://hub.subspace.services/books/software/page/graphic-card-integration "Graphic Card Integration") to Docker containers.</p>

<details id="bkmrk-db_root_pass-this-is"><summary>Intel Embedded Graphics</summary>

Modern Intel processors have an embedded graphic processor that can be used for hardware acceleration within this container.</details><details id="bkmrk-amd-graphics-amd-and"><summary>AMD Graphics</summary>

AMD and ATI graphic cards can be used for hardware acceleration within this container [after an initial setup](https://hub.subspace.services/books/software/page/graphic-card-integration "Graphic Card Integration").

</details><details id="bkmrk-nvidia-graphics-nvid"><summary>Nvidia Graphics</summary>

Nvidia graphics cards can be used for hardware acceleration within this container [after an initial setup](https://hub.subspace.services/books/software/page/graphic-card-integration "Graphic Card Integration").

</details>

# Installation

The service can be installed through the Portainer web interface.

<p class="callout info">Learn about [creating a new stack](https://hub.subspace.services/books/portainer/page/creating-a-new-stack "Creating a New Stack").</p>

## Docker Compose

### Intel and AMD Graphics   


Use the following code to install the service:

```yaml
---
services:
  jellyfin:
    image: lscr.io/linuxserver/jellyfin:latest
    container_name: jellyfin
    network_mode: bridge
    environment:
      - PUID=1000
      - PGID=1000
      - TZ=America/Vancouver
    volumes:
      # Persistent Data
      - /srv/jellyfin:/config

      # Media Folders
      - /mnt/movies:/mmt/movies
      - /mnt/television:/mmt/television
      - /mnt/music:/mmt/music
      - /mnt/books:/mmt/books
    devices:
      - /dev/dri:/dev/dri
    ports:
      - 8096:8096
      - 8920:8920
      - 7359:7359/udp
      - 1900:1900/udp
    restart: unless-stopped
```

## Nvidia Graphics   


Use the following code to install the service:

```yaml
---
services:
  jellyfin:
    image: lscr.io/linuxserver/jellyfin:latest
    container_name: jellyfin
    network_mode: bridge
    runtime: nvidia
    environment:
      - PUID=1000
      - PGID=1000
      - TZ=America/Vancouver
      - NVIDIA_VISIBLE_DEVICES=all
    volumes:
      # Persistent Data
      - /srv/jellyfin:/config

      # Media Folders
      - /mnt/movies:/mmt/movies
      - /mnt/television:/mmt/television
      - /mnt/music:/mmt/music
      - /mnt/books:/mmt/books
    ports:
      - 8096:8096
      - 8920:8920
      - 7359:7359/udp
      - 1900:1900/udp
    restart: unless-stopped
```

# Updating

<p class="callout success">Re-Deploy the Stack</p>

This service has been optimized for running in Docker thanks to [LinuxServer.io](https://linuxserver.io).

This allows you to [re-deploy the stack through Portainer](https://hub.subspace.services/books/portainer/page/updating-a-stack "Updating a Stack") to download the latest updates.

# User Manual

# Development

<p class="callout info">This software is released under the [GPL-2.0 license](https://opensource.org/license/gpl-2-0).</p>

The software was developed as a fork of [Emby after it changed to a closed-source model](https://www.linuxuprising.com/2018/12/jellyfin-free-software-emby-media.html?m=1). Jellyfin is made available for Docker through the efforts of [LinuxServer.io](https://docs.linuxserver.io/images/docker-jellyfin/) and their commitment to simplifying self-hosting.

You can learn more about how to contribute to Jellyfin through their [website](https://jellyfin.org/contribute/).

The Jellyfin development team also accepts [sponsorships](https://opencollective.com/jellyfin).

# Resources

## Official

- [Official Wiki](https://jellyfin.org/docs)
- [Official Matrix](https://matrix.to/#/#jellyfinorg:matrix.org)
- [Official GitHub Repository](https://github.com/jellyfin/jellyfin)
- [Official Website](https://jellyfin.org)
- [Getting Started Guide](https://jellyfin.org/docs/#getting-started)
- [Frequently Asked Questions](https://jellyfin.org/docs/general/faq)
- [General Troubleshooting](https://jellyfin.org/docs/general/getting-help)

## LinuxServer.io

- [Docker Image](https://docs.linuxserver.io/images/docker-jellyfin)
- <div>[Official Website](https://www.linuxserver.io/)</div>
- <div>[Official Documentation](https://docs.linuxserver.io/)</div>
- <div>[Official Discord](https://linuxserver.io/discord)</div>
- <div>[Official Forum](https://discourse.linuxserver.io/)</div>
- <div>[Official GitLab Repository](https://gitlab.com/Linuxserver.io)</div>
- [Frequently Asked Questions](https://docs.linuxserver.io/FAQ/)