Jellyfin

https://jellyfin.org/docs
Admin
Jellyfin is a free and open-source media system for managing and streaming media from a dedicated...
Tokens:154,121
Snippets:1,263
Trust Score:9.9
Update:2 weeks ago
Show doc for...
Tokens:
Raw
### Example docker create command with personal settings

Source: https://jellyfin.org/docs/general/networking/letsencrypt

Example of the docker create command adjusted for a specific setup: timezone America/Chicago, subdomain jellyfin, HTTP validation, and custom ports. Personal information is redacted.

```bash
docker create --name=swag --cap-add=NET_ADMIN -e PUID=1000 -e PGID=1000 -e TZ=America/Chicago -e URL=example.com -e SUBDOMAINS=jellyfin -e VALIDATION=http -e EMAIL=email@email.com -e DHLEVEL=2048 -e ONLY_SUBDOMAINS=false -e STAGING=false -p 443:443 -p 80:80 -v /path/to/appdata/swag/:/config --restart unless-stopped linuxserver/swag  
```

--------------------------------

### Create SWAG Docker container (example)

Source: https://jellyfin.org/docs/general/post-install/networking/advanced/letsencrypt

Example docker create command for the SWAG container with personal information redacted. Adjusts the template for region, ports, and path. After creation, start with `docker start swag`.

```bash
docker create --name=swag --cap-add=NET_ADMIN -e PUID=1000 -e PGID=1000 -e TZ=America/Chicago -e URL=example.com -e SUBDOMAINS=jellyfin -e VALIDATION=http -e EMAIL=email@email.com -e DHLEVEL=2048 -e ONLY_SUBDOMAINS=false -e STAGING=false -p 443:443 -p 80:80 -v /path/to/appdata/swag/:/config --restart unless-stopped linuxserver/swag
```

--------------------------------

### Enable and start Jellyfin service

Source: https://jellyfin.org/docs/general/installation/advanced/manual

Sets correct permissions, reloads systemd, enables the service to start on boot, and starts it immediately.

```bash
sudo chmod 644 jellyfin.service  

sudo systemctl daemon-reload  

sudo systemctl enable jellyfin.service  

sudo systemctl start jellyfin.service  

```

--------------------------------

### Start Jellyfin from PowerShell

Source: https://jellyfin.org/docs/general/installation/advanced/source

Starts the Jellyfin server executable from PowerShell after installation.

```powershell
&"$env:APPDATA\Jellyfin-Server\jellyfin.exe"  

```

--------------------------------

### Setup Docker container and build master branch

Source: https://jellyfin.org/docs/general/contributing/development

Run these commands inside the 'jftest' container to install dependencies, clone the Jellyfin repositories, build the server and web client, and clean up. The container restarts when the entrypoint terminates, so re-exec into it after each command. The final 'kill' command reloads the new version.

```bash
docker exec -ti jftest bash  

apt-get update && apt-get install -y git gnupg curl autoconf g++ make libpng-dev gifsicle automake libtool gcc musl-dev nasm ca-certificates  

curl -fsSL https://packages.microsoft.com/keys/microsoft.asc | gpg --dearmor -o /usr/share/keyrings/microsoft-prod.gpg  

curl -LO https://packages.microsoft.com/config/debian/12/prod.list && mv prod.list /etc/apt/sources.list.d/microsoft-prod.list  

apt-get update && apt-get install -y dotnet-sdk-8.0  

curl -fsSL https://deb.nodesource.com/gpgkey/nodesource-repo.gpg.key | gpg --dearmor -o /etc/apt/keyrings/nodesource.gpg  

echo "deb [signed-by=/etc/apt/keyrings/nodesource.gpg] https://deb.nodesource.com/node_20.x nodistro main" | tee /etc/apt/sources.list.d/nodesource.list  

apt-get update && apt-get install -y nodejs  

cd /opt && git clone https://github.com/jellyfin/jellyfin.git && git clone https://github.com/jellyfin/jellyfin-web.git  

cd jellyfin/ && DOTNET_CLI_TELEMETRY_OPTOUT=1 && DOTNET_CLI_HOME="/tmp/" dotnet publish Jellyfin.Server --configuration Debug --output="/jellyfin" --self-contained --runtime linux-x64  

cd /opt/jellyfin-web && npm install && npm run build:development && cp -r /opt/jellyfin-web/dist /jellyfin/jellyfin-web  

apt-get remove -y gnupg curl && apt-get clean -y autoclean && apt-get autoremove -y  

kill -15 $(pidof jellyfin)  

```

--------------------------------

### Install Intel firmware on Ubuntu

Source: https://jellyfin.org/docs/general/post-install/transcoding/hardware-acceleration/intel

Install the linux-firmware package on Ubuntu to get Intel graphics firmware.

```bash
sudo apt update && sudo apt install -y linux-firmware
```

--------------------------------

### Portable Windows Install Commands

Source: https://jellyfin.org/docs/general/installation/advanced/manual

Commands for the portable Windows installation. The first three are example lines for jellyfin.bat: default data location, custom data location with -d, and custom data location with -d plus -noautorunwebapp to disable webapp auto-start. The last command runs jellyfin.bat to start the server.

```bat
<--Your install path-->\jellyfin\system\jellyfin.exe
```

```bat
<--Your install path-->\jellyfin\system\jellyfin.exe -d <--Your install path-->\jellyfin\data
```

```bat
<--Your install path-->\jellyfin\system\jellyfin.exe -d <--Your install path-->\jellyfin\data -noautorunwebapp
```

```bat
jellyfin.bat
```

--------------------------------

### Install curl and gnupg

Source: https://jellyfin.org/docs/general/installation/advanced/manual

Installs `curl` and `gnupg` as prerequisites for the manual repository installation.

```bash
sudo apt install curl gnupg  

```

--------------------------------

### Start Jellyfin from CMD

Source: https://jellyfin.org/docs/general/installation/advanced/source

Starts the Jellyfin server executable from the Windows Command Prompt.

```cmd
%APPDATA%\Jellyfin-Server\jellyfin.exe  

```

--------------------------------

### Install Mopidy Jellyfin on Raspberry Pi

Source: https://jellyfin.org/docs/general/clients/mopidy

Install Mopidy and required OS packages on a Raspberry Pi, then install the Jellyfin extension and enable the Mopidy service.

```bash
sudo apt install mopidy mopidy-mpd gstreamer1.0-plugins-bad python3-pip  
```

```bash
sudo pip3 install mopidy-jellyfin mopidy-musicbox-webclient  
```

```bash
sudo systemctl enable --now mopidy  
```

--------------------------------

### Install Jellyfin on Gentoo

Source: https://jellyfin.org/docs/general/installation/advanced/community

Install the Jellyfin package on Gentoo using the ebuild repository.

```bash
emerge --ask www-apps/jellyfin-bin  
```

--------------------------------

### Install Jellyfin metapackage

Source: https://jellyfin.org/docs/general/installation/advanced/manual

Installs the Jellyfin metapackage, which automatically fetches the various sub-packages.

```bash
sudo apt install jellyfin  

```

--------------------------------

### Run Jellyfin

Source: https://jellyfin.org/docs/general/installation/advanced/manual

Runs the Jellyfin startup script. Expect lots of log output; setup is done in the web browser as usual.

```bash
./jellyfin.sh  

```

--------------------------------

### Copy the nginx proxy configuration sample

Source: https://jellyfin.org/docs/general/networking/letsencrypt

Command to copy the sample configuration file for a subdomain setup, removing the .sample extension. Use jellyfin.subfolder.conf.sample for subfolder setups.

```bash
cp jellyfin.subdomain.conf.sample jellyfin.subdomain.conf
```

--------------------------------

### Podman run example with hardware acceleration

Source: https://jellyfin.org/docs/general/installation/container?method=docker-compose

Podman run command for Jellyfin with hardware acceleration, rootless user mapping, SELinux relabeling, and read-only media bind mount. Includes commented-out security-opt for older container-selinux.

```bash
   podman run \  
    --detach \  
    --label "io.containers.autoupdate=registry" \  
    --name myjellyfin \  
    --publish 8096:8096/tcp \  
    --device /dev/dri/:/dev/dri/ \  
    # --security-opt label=disable # Only needed for older versions of container-selinux < 2.226  
    --rm \  
    --user $(id -u):$(id -g) \  
    --userns keep-id \  
    --volume jellyfin-cache:/cache:Z \  
    --volume jellyfin-config:/config:Z \  
    --mount type=bind,source=/path/to/media,destination=/media,ro=true,relabel=private \  
    docker.io/jellyfin/jellyfin:latest  


```

--------------------------------

### Install Intel firmware on Arch Linux

Source: https://jellyfin.org/docs/general/post-install/transcoding/hardware-acceleration/intel

Install the linux-firmware package on Arch Linux to get Intel graphics firmware.

```bash
sudo pacman -Syu linux-firmware
```

--------------------------------

### Install Jellyfin via RPM Fusion

Source: https://jellyfin.org/docs/general/installation/advanced/community

Install Jellyfin on Fedora/CentOS/RPM distributions using RPM Fusion. First enable rpmfusion, then install the jellyfin package (which pulls in jellyfin-server, jellyfin-web, and jellyfin-firewalld), and finally enable and start the service.

```bash
sudo dnf install https://mirrors.rpmfusion.org/free/fedora/rpmfusion-free-release-$(rpm -E %fedora).noarch.rpm https://mirrors.rpmfusion.org/nonfree/fedora/rpmfusion-nonfree-release-$(rpm -E %fedora).noarch.rpm  
```

```bash
sudo dnf install jellyfin  
```

```bash
sudo systemctl enable --now jellyfin  
```

--------------------------------

### Create and enter Jellyfin directory

Source: https://jellyfin.org/docs/general/installation/advanced/manual

Creates the Jellyfin directory in /opt and changes into it. Run these commands as root (sudo) before downloading the archive.

```bash
sudo mkdir /opt/jellyfin  

cd /opt/jellyfin  

```

--------------------------------

### docker ps output for SWAG container

Source: https://jellyfin.org/docs/general/post-install/networking/advanced/letsencrypt

Example output of `docker ps` after starting the SWAG container, showing the container ID, image, command, status, and port mappings.

```text
CONTAINER ID        IMAGE                     COMMAND             CREATED             STATUS              PORTS                                      NAMES
09346434b8ea        linuxserver/swag          "/init"             2 minutes ago       Up 5 seconds        0.0.0.0:80->80/tcp, 0.0.0.0:443->443/tcp   swag
```

--------------------------------

### Use build script on Linux or macOS

Source: https://jellyfin.org/docs/general/installation/advanced/source

Shows the build script help, lists available platforms, and performs a build for a specified platform. The resulting archives are placed in ../bin/<platform>.

```bash
./build --help  

./build --list-platforms  

./build <platform> all  

```

--------------------------------

### Caddy reverse proxy configuration for Tailscale

Source: https://jellyfin.org/docs/general/post-install/networking/tailscale

Example Caddy configuration for a reverse proxy setup with Tailscale. Assumes the server has Tailscale IP 100.12.34.56 and proxies /jellyfin/* to port 8096.

```caddyfile
example.com  

redir /jellyfin /jellyfin/  

reverse_proxy /jellyfin/* 100.12.34.56:8096  

```

--------------------------------

### Download and install Jellyfin GPG key

Source: https://jellyfin.org/docs/general/installation/advanced/manual

Creates the keyrings directory and downloads the Jellyfin GPG signing key, dearmoring it into `/etc/apt/keyrings/jellyfin.gpg`.

```bash
sudo mkdir -p /etc/apt/keyrings  

curl -fsSL https://repo.jellyfin.org/jellyfin_team.gpg.key | sudo gpg --dearmor -o /etc/apt/keyrings/jellyfin.gpg  

```

--------------------------------

### Border Color tweak: chain selectors to set border-color

Source: https://jellyfin.org/docs/general/clients/css-customization

Applies a red border color to multiple Jellyfin input elements by chaining selectors. This is the 'Border Color' tweak example from the CSS customization guide.

```css
.emby-input,  
.emby-textarea,  
.emby-select {  
  border-color: #d00000;  
}  

```

--------------------------------

### Run Jellyfin server

Source: https://jellyfin.org/docs/general/testing/server/macos

Start the Jellyfin server with the custom FFmpeg path. Press CONTROL+C to stop gracefully.

```bash
/path/to/jellyfin-folder/jellyfin --ffmpeg /path/to/ffmpeg-folder/ffmpeg  
```

--------------------------------

### Migrate from Emby 3.5.2 to Jellyfin

Source: https://jellyfin.org/docs/general/administration/migrate

Commands to migrate from Emby 3.5.2 to Jellyfin on Debian-based Linux. Stop the Emby service, move its data directory, purge the emby-server package, install Jellyfin, stop the Jellyfin service, copy the backup data, fix ownership, mark the Startup Wizard as completed, and start Jellyfin.

```bash
sudo service emby-server stop  
```

```bash
sudo mv /var/lib/emby /var/lib/emby.backup  
```

```bash
sudo apt purge emby-server  
```

```bash
sudo service jellyfin stop  
```

```bash
sudo cp -a /var/lib/emby.backup/* /var/lib/jellyfin/  
```

```bash
sudo chown -R jellyfin:jellyfin /var/lib/jellyfin  
```

```bash
sudo sed -i '/IsStartupWizardCompleted/s/false/true/' /etc/jellyfin/system.xml  
```

```bash
sudo service jellyfin start  
```

--------------------------------

### Jellyfin startup script

Source: https://jellyfin.org/docs/general/installation/advanced/manual

Startup script that runs the Jellyfin binary with the required data, cache, config, log, and ffmpeg options. Adjust the paths if you customized the installation.

```bash
#!/bin/bash  

JELLYFINDIR="/opt/jellyfin"  

FFMPEGDIR="/usr/share/jellyfin-ffmpeg"  

  

$JELLYFINDIR/jellyfin/jellyfin \  

 -d $JELLYFINDIR/data \  

 -C $JELLYFINDIR/cache \  

 -c $JELLYFINDIR/config \  

 -l $JELLYFINDIR/log \  

 --ffmpeg $FFMPEGDIR/ffmpeg  

```

--------------------------------

### Install IPBan on Windows

Source: https://jellyfin.org/docs/general/post-install/networking/advanced/ipban

Install IPBan on Windows from an elevated PowerShell prompt. This command downloads and executes the official installation script.

```powershell
[Net.ServicePointManager]::SecurityProtocol = [Net.SecurityProtocolType]::Tls12; iex ((New-Object System.Net.WebClient).DownloadString('https://raw.githubusercontent.com/DigitalRuby/IPBan/master/IPBanCore/Windows/Scripts/install_latest.ps1'))  
```

--------------------------------

### Inspect Jellyfin install script

Source: https://jellyfin.org/docs/general/installation/linux

Optionally inspect the downloaded script to see what it does before executing it.

```bash
less install-debuntu.sh  


```

--------------------------------

### Install NVIDIA NVENC/NVDEC packages on Debian

Source: https://jellyfin.org/docs/general/post-install/transcoding/hardware-acceleration/nvidia

Installs libnvcuvid1 and libnvidia-encode1 for NVENC and NVDEC support on Debian. Requires the NVIDIA proprietary driver to be installed first.

```bash
sudo apt update && sudo apt install -y libnvcuvid1 libnvidia-encode1  
```

--------------------------------

### Bind Mount Multiple Media Libraries

Source: https://jellyfin.org/docs/general/installation/container?method=docker-compose

Shows how to bind mount multiple media directories into the Jellyfin container.

```bash
--mount type=bind,source=/path/to/media1,target=/media1

--mount type=bind,source=/path/to/media2,target=/media2,readonly

...etc
```

--------------------------------

### Install NVIDIA driver utilities on Arch Linux

Source: https://jellyfin.org/docs/general/post-install/transcoding/hardware-acceleration/nvidia

Installs nvidia-utils for NVENC and NVDEC support on Arch Linux. Requires the NVIDIA proprietary driver to be installed first.

```bash
sudo pacman -Syu nvidia-utils  
```

--------------------------------

### Prepare Jellyfin server binaries

Source: https://jellyfin.org/docs/general/testing/server/macos

Remove the quarantine flag and create an ad-hoc signature for the Jellyfin server binaries.

```bash
cd /path/to/jellyfin  

xattr -rd com.apple.quarantine .  

codesign -fs - --deep jellyfin  
```
Tokens:
Raw