Sam: Created article

2024-09-10T19:33:45Z

Created article

New page

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.9.11.

== What you need to know ==

You will need to download the following:
* Jellyfin Generic Linux Server package
* <code>jellyfin-ffmpeg</code>tarball

The following packages need installing:
* <code>gcc</code>
* <code>make</code>
* <code>yasm</code>

The following packages need installing from Packman:
* <code>libx264-devel</code> - required
* <code>libx265-devel</code> - optional for H.265/HEVC transcoding
* <code>SVT-AV1-devel</code> - optional for AV1 transcoding

== Installing Jellyfin ==

* Create the directory <code>sudo mkdir /opt/jellyfin</code>
* Move into the directory <code>cd /opt/jellyfin</code>
* Download the latest tarball from the [https://repo.jellyfin.org/?path=/server/linux/latest-stable/amd64 Jellyfin website] - for example, <code>wget https://repo.jellyfin.org/files/server/linux/latest-stable/amd64/jellyfin_10.9.11-amd64.tar.gz</code>
* Unzip the tar archive, <code>sudo tar zxvf jellyfin_10.9.11-amd64.tar.gz</code>
* We need to create the script to run Jellyfin and run it as a service. Open <code>sudo nano jellyfin.sh</code> 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 to save the file
* Run <code>sudo chmod +x jellyfin.sh</code> to make the script executable
* Move back into the Jellyfin directory and initially run the Jellyfin script created earlier <code>./jellyfin.sh</code>
* Once it has started, close the script by pressing Ctrl+C
* Move up a directory <code>cd ..</code>. Take ownership of the file under the user you are running <code>sudo chown -R <username>:users jellyfin</code>. '''Note:''' <code><username></code> needs changing to whatever your username is

=== Install service script ===

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

* Move to <code>cd /etc/systemd/system</code>
* We need to create the script to run Jellyfin as a service. Open <code>sudo nano jellyfin.service</code> and add the following to the script file:
[Unit]
Description=Jellyfin
After=network.target

[Service]
Type=simple
User=<username>
Restart=always
ExecStart=/opt/jellyfin/jellyfin.sh

[Install]
WantedBy=multi-user.target

'''Note:''' <code>User=<username></code> should be changed to the same user that took ownership of the Jellyfin folder earlier.
* Press Ctrl+W to save the file
* Correct the permissions of the service file <code>sudo chmod 644 jellyfin.service</code>
* Reload the system daemons to allow the service to load <code>sudo systemctl daemon-reload</code>
* Run the Jellyfin service and check it starts <code>sudo service jellyfin start</code>
* If you'd like Jellyfin to run on startup, run <code>sudo systemctl enable jellyfin.service</code>

== Install <code>jellyfin-ffmpeg</code> ==

openSUSE does not come with an FFMpeg version that includes propriety formats such as H.264 and H.265/HEVC. We need to install <code>jellyfin-ffmpeg</code> 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 <code>sudo zypper addrepo -cfp 90 'https://ftp.gwdg.de/pub/linux/misc/packman/suse/openSUSE_Leap_$releasever/' packman</code>
* Refresh zypper to load the new repositories <code>sudo zypper ref</code>. Accept the keys needed for the repositories.
* Install the base proprietary codecs <code>sudo zypper install --allow-vendor-change --from packman ffmpeg gstreamer-plugins-{good,bad,ugly,libav} libavcodec vlc-codecs</code>
* Install the dependency packages depending on what you need: <code>sudo zypper in libx264-devel libx265-devel SVT-AV1-devel</code>. Allow any extra dependencies these may require.
* Install the base packages need to compile <code>jellyfin-ffmpeg</code>: <code>sudo zypper in gcc make yasm</code>
* Move to your home downloads folder <code>cd ~/Downloads</code>
* Download the <code>jellyfin-ffmpeg</code> from [https://github.com/jellyfin/jellyfin-ffmpeg/releases GitHub]. Ensure that the version is compatible with the version of Jellyfin you have installed - for example Jellyfin 10.9.11 is compatible with the latest <code>jellyfin-ffmpeg</code> package 6.0.1-8. Download the source tar.gz package with <code>wget https://github.com/jellyfin/jellyfin-ffmpeg/archive/refs/tags/v6.0.1-8.tar.gz</code>.
'''Tip:''' You may need to expand the Assets tab to show the downloadable packages.
* Extract the package with <code>tar zxvf v6.0.1-8.tar.gz</code>
* Move into the folder created <code>cd jellyfin-ffmpeg-6.0.1-8</code>
* Run <code>./configure --prefix=/usr/share/jellyfin-ffmpeg --enable-libx264 --enable-libx265 --enable-libsvtav1 --enable-gpl</code>.
This will configure the package to be installed to <code>/usr/share/jellyfin-ffmeg</code> 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 <code>make</code>. This will compile the code and may take a while
* Run <code>make install</code> to install

== Configuring Jellyfin ==

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

Installing Jellyfin - Revision history

Sam: Created article