Installing Jellyfin

Jellyfin is a free and open-source media server and suite of multimedia applications designed to organize, manage, and share digital media files to networked devices.

An RPM package is not provided for openSUSE so Jellyfin must be installed from the Linux manual install tarball. This guide will explain how to do this. This guide is written with the current version of Jellyfin 10.10.7.

What you need to know

You will need to download the following:

• Jellyfin Generic Linux Server package
• jellyfin-ffmpegtarball

The following packages need installing:

• gcc
• make
• yasm

The following packages need installing from Packman:

• libx264-devel - required
• libx265-devel - optional for H.265/HEVC transcoding
• SVT-AV1-devel - optional for AV1 transcoding

Installing Jellyfin

• Create the directory sudo mkdir /opt/jellyfin
• Move into the directory cd /opt/jellyfin
• Download the latest tarball from the Jellyfin website - for example, sudo wget https://repo.jellyfin.org/files/server/linux/latest-stable/amd64/jellyfin_10.10.7-amd64.tar.xz
• Unzip the tar archive, sudo tar Jxvf jellyfin_10.10.7-amd64.tar.xz
• We need to create the script to run Jellyfin and run it as a service. Open sudo nano jellyfin.sh and add the following to the script file:

#!/bin/bash
JELLYFINDIR="/opt/jellyfin"
FFMPEGDIR="/usr/share/jellyfin-ffmpeg/bin"

$JELLYFINDIR/jellyfin/jellyfin \
 -d $JELLYFINDIR/data \
 -C $JELLYFINDIR/cache \
 -c $JELLYFINDIR/config \
 -l $JELLYFINDIR/log \
 --ffmpeg $FFMPEGDIR/ffmpeg

• Press Ctrl+W then Y to save the file
• Run sudo chmod +x jellyfin.sh to make the script executable

Install service script

This will guide you on how to create a script to start Jellyfin as a service on startup.

• Move to cd /etc/systemd/system
• We need to create the script to run Jellyfin as a service. Open sudo nano jellyfin.service and add the following to the script file:

[Unit]
Description=Jellyfin
After=network.target

[Service]
Type=simple
User=root
Restart=always
ExecStart=/opt/jellyfin/jellyfin.sh

[Install]
WantedBy=multi-user.target

• Press Ctrl+W then Y to save the file
• Correct the permissions of the service file sudo chmod 644 jellyfin.service

Install jellyfin-ffmpeg

openSUSE does not come with an FFmpeg version that includes propriety formats such as H.264 and H.265/HEVC. We need to install jellyfin-ffmpeg which includes these formats and is tailored for hardware encoding for Jellyfin. A few dependencies need installing first.

• We need to add the Packman repository that includes the dependencies we need sudo zypper addrepo -cfp 90 'https://ftp.gwdg.de/pub/linux/misc/packman/suse/openSUSE_Leap_$releasever/' packman
• Refresh zypper to load the new repositories sudo zypper ref. Accept the keys needed for the repositories.
• Install the base proprietary codecs sudo zypper install --allow-vendor-change --from packman ffmpeg gstreamer-plugins-{good,bad,ugly,libav} libavcodec vlc-codecs
• Install the dependency packages depending on what you need: sudo zypper in libx264-devel libx265-devel SVT-AV1-devel. Allow any extra dependencies these may require.
• Install the base packages need to compile jellyfin-ffmpeg: sudo zypper in gcc make yasm
• Move to your home downloads folder cd ~/Downloads
• Download the jellyfin-ffmpeg from GitHub. Ensure that the version is compatible with the version of Jellyfin you have installed (sometimes you may have to use an older ffmpeg package, depending on the version of Jellyfin you are installing) - for example Jellyfin 10.10.7 is compatible with the latest jellyfin-ffmpeg package 7.1.2-2. Download the source tar.gz package with wget https://github.com/jellyfin/jellyfin-ffmpeg/archive/refs/tags/v7.1.2-2.tar.gz.

Tip: You may need to expand the Assets tab to show the downloadable packages.

• Extract the package with tar zxvf v7.1.2-2.tar.gz
• Move into the folder created cd jellyfin-ffmpeg-7.1.2-2
• Run ./configure --prefix=/usr/share/jellyfin-ffmpeg --enable-libx264 --enable-libx265 --enable-libsvtav1 --enable-gpl.

This will configure the package to be installed to /usr/share/jellyfin-ffmeg with H.264, H.265/HEVC and AV1. Due to H.264 and H.265/HEVC being licensed under a GPL license, the whole package will be licensed under GPL which is enabled by the switch. This can be configured as needed by adding/removing switches.

• Run make. This will compile the code and may take a while
• Run sudo make install to install

Inital run and starting the service

We need to run Jellyfin so that the initial directories needed for running are created.

• Move back into the Jellyfin directory and initially run the Jellyfin script created earlier sudo ./jellyfin.sh
• Check that it runs correctly with no errors (indicated by [ERR] or [FTL]in red
• Once it has started, close the script by pressing Ctrl+C
• Reload the system daemons to allow the service to load sudo systemctl daemon-reload
• Run the Jellyfin service and check it starts sudo systemctl start jellyfin
• If you'd like Jellyfin to run on startup, run sudo systemctl enable jellyfin

Configuring Jellyfin

Jellyfin is configured through the web browser. Open a web browser and go to the following address: http://localhost:8096. You should get the first run installer after installation is complete.

Tip: If you are reinstalling and starting from scratch, run a private window of your browser to set the server up or it will keep trying to connect to the old server from before. You may need to delete the site settings to get it working again.