By the end of this guide, you’ll have a spiffy Jellyfin Media Server humming along, ready to serve your favorite shows and movies. So, let’s dive in!<\/p>\n\n\n\n
Prerequisites<\/h2>\n\n\n\n
Before we set sail, let\u2019s ensure we have all our digital tools in the box. In this light, installing Docker and Docker Compose is required to deploy a containerized Jellyfin.<\/p>\n\n\n\n
So, if you don\u2019t already have Docker installed, any of the following guides will be helpful:<\/p>\n\n\n\n
- \n
- How to Install Docker on Ubuntu 22.04<\/a><\/li>\n\n\n\n
- How to Install Docker on Debian 12 (Bookworm)<\/a><\/li>\n\n\n\n
- How to Install Docker on AlmaLinux \/ Rocky Linux<\/a><\/li>\n\n\n\n
- How to Install Docker on Fedora<\/a><\/li>\n\n\n\n
- How to Install Docker on Linux Mint 21<\/a><\/li>\n\n\n\n
- How to Install Docker on Raspberry Pi<\/a><\/li>\n<\/ul>\n\n\n\n
The other essential component is Docker Compose. Remember, it is provided separately from Docker. Therefore, you must Install Docker before adding Docker Compose; otherwise, Compose will not function.<\/p>\n\n\n\n
Installing it is pretty simple, even if it is not already on your Linux system. To install Docker Compose<\/a>, type the following two commands:<\/p>\n\n\n
sudo curl -L \"https:\/\/github.com\/docker\/compose\/releases\/latest\/download\/docker-compose-linux-$(uname -m)\"<\/span> -o \/usr\/local\/bin\/docker-compose\nsudo chmod +x \/usr\/local\/bin\/docker-compose<\/code><\/span>Code language:<\/span> JavaScript<\/span> (<\/span>javascript<\/span>)<\/span><\/small><\/pre>\n\n\nInstall Jellyfin with Docker Compose<\/h2>\n\n\n\n
It is time to get to the installation, armed with all the necessary tools.<\/p>\n\n\n\n
Step 1: Setting up Working Directory<\/h3>\n\n\n\n
The first step is to create the project directory in which our Docker Compose deployment file will be placed. Then switch to it; from here on, you need to execute all commands further down in this guide from that location.<\/p>\n\n\n
mkdir jellyfin\ncd jellyfin<\/code><\/span><\/pre>\n\n\nStep 2: Create a Docker Compose File<\/h3>\n\n\n\n
Next, we must create a “docker-compose.yaml<\/em>” file, like a blueprint for our Docker setup. This file will define the services, volumes, ports, etc., telling Docker Compose what to do and how to set up our Jellyfin instance.<\/p>\n\n\n\n
So, open your favorite text editor and paste the following content into it:<\/p>\n\n\n
nano<\/span> docker-compose<\/span>.yaml<\/span><\/code><\/span>Code language:<\/span> CSS<\/span> (<\/span>css<\/span>)<\/span><\/small><\/pre>\n\nversion: \"3\"<\/span>\nservices:\n jellyfin:\n image: lscr.io\/linuxserver\/jellyfin:latest\n container_name: jellyfin\n environment:\n - PUID=1000<\/span>\n - PGID=1000<\/span>\n - TZ=America\/New_York\n volumes:\n - jellyfin-config:\/config\n - \/home\/linuxiac\/media:\/media\n ports:\n - 8096<\/span>:8096<\/span>\n restart: unless-stopped\nvolumes:\n jellyfin-config:<\/code><\/span>Code language:<\/span> PHP<\/span> (<\/span>php<\/span>)<\/span><\/small><\/pre>\n\n\n<\/div>\n\n\n\nOf course, don’t forget to change<\/strong> the directive “\/home\/linuxiac\/media<\/em>” in the file above’s “volumes<\/em>” section to the full path to the directory of the computer on which you are running the dockerized Jellyfin instance, which contains the media content it will stream.<\/p>\n\n\n\n
In other words, this directory will be mounted in the Jellyfin container’s filesystem in “\/media<\/em>.” This is where your movies, photos, music, etc., are expected to reside.<\/p>\n\n\n\n
For the purposes of this guide, we have placed two directories inside it containing movies and photos.<\/p>\n\n\n\n
![\"The](\"https:\/\/linuxiac.com\/wp-content\/uploads\/2023\/10\/jellyfin-media-files-directory.jpg\")
<\/a>The directory that stores our media content.<\/figcaption><\/figure>\n\n\n\n Don’t forget to change the time zone (“TZ<\/em> “) to the correct one for you. A full list of all such can be found here<\/a>.<\/p>\n\n\n\n
Step 3: Deploy Jellyfin with Docker Compose<\/h3>\n\n\n\n
With the “docker-compose.yaml<\/em>” file defined, we are all set to run our dockerized Jellyfin instance using Docker Compose. So, ensure you are in the directory containing the file, and execute the following command to start and run the container in the background:<\/p>\n\n\n
docker-compose up -d<\/code><\/span><\/pre>\n\n\n<\/div>\n\n\n\nThe Docker image will start downloading. In the end, you should see a screen similar to the one below, informing you that your Jellyfin server installation has been successfully deployed and is up and running.<\/p>\n\n\n\n
![\"Install](\"https:\/\/linuxiac.com\/wp-content\/uploads\/2023\/10\/jellyfin-deployment-start.jpg\")
<\/a>Install the Jellyfin media server with Docker Compose.<\/figcaption><\/figure>\n\n\n\n Access & Configure Jellyfin<\/h2>\n\n\n\n
Once the container is up and running, you can access the Jellyfin web interface by navigating to “http:\/\/your-server-ip:8096<\/em><\/strong>” in your web browser. If you are accessing it from the same machine the container is running on, you can also use “http:\/\/localhost:8096<\/em>.”<\/p>\n\n\n\n
The Jellyfin wizard will greet you. Select your preferred display language and click “Next<\/em>.”<\/p>\n\n\n\n
![\"Select](\"https:\/\/linuxiac.com\/wp-content\/uploads\/2023\/10\/jellyfin-conf001-1024x579.jpg\")
<\/a>Select your preferred language.<\/figcaption><\/figure>\n\n\n\n The Jellyfin server’s admin account will be created on the next screen. Enter a username and password of your choice and continue by clicking “Next<\/em>.”<\/p>\n\n\n\n
![\"Create](\"https:\/\/linuxiac.com\/wp-content\/uploads\/2023\/10\/jellyfin-conf002-1024x766.jpg\")
<\/a>Create Jellyfin’s admin account.<\/figcaption><\/figure>\n\n\n\n It is time to tell Jellyfin where our media content is. Click on the “Add Media Library<\/em>” button.<\/p>\n\n\n\n
![\"Setting](\"https:\/\/linuxiac.com\/wp-content\/uploads\/2023\/10\/jellyfin-conf03-1024x667.jpg\")
<\/a>Setting up a media directory.<\/figcaption><\/figure>\n\n\n\n Select the content type, such as “Movies<\/em>,” “Music<\/em>,” “Photos<\/em>,” etc., then click on the plus (“+<\/em> “) button to specify where the directory is physically located in the container’s file system. In our case, we will add a directory containing movies.<\/p>\n\n\n\n
![\"Setting](\"https:\/\/linuxiac.com\/wp-content\/uploads\/2023\/10\/jellyfin-conf04-1024x744.jpg\")
<\/a>Setting up a media directory.<\/figcaption><\/figure>\n\n\n\n To navigate, simply click on the directory names that you see until the complete path – for example, “\/media\/movies<\/em>” – is presented in the “Folder<\/em>” field.<\/p>\n\n\n\n
Important clarification! This is the path to the filesystem inside the container, referenced in the “volumes<\/em>” part of our “docker-compose.yaml<\/em>” file. Not to be confused with that of the server on which the container itself is running.<\/p>\n\n\n\n
In other words, on our host, the directory is, for example, “\/home\/linuxiac\/media<\/em>,” but inside the container, it is mounted as “\/media.”<\/p>\n\n\n\n
![\"Setting](\"https:\/\/linuxiac.com\/wp-content\/uploads\/2023\/10\/jellyfin-conf05-1024x744.jpg\")
<\/a>Setting up a media directory.<\/figcaption><\/figure>\n\n\n\n The directory will be previewed in the “Folders<\/em>” section so we can move on by clicking the “OK<\/em>” button, keeping the other settings at default.<\/p>\n\n\n\n
![\"Setting](\"https:\/\/linuxiac.com\/wp-content\/uploads\/2023\/10\/jellyfin-conf06-1024x744.jpg\")
<\/a>Setting up a media directory.<\/figcaption><\/figure>\n\n\n\n On the next screen, you will view the currently added directories. If you want, add others following the steps described above.<\/p>\n\n\n\n
Don’t worry about having to add all at once now. At a later stage, you can modify the settings of each one, remove, or add a new one, as we will show you at the end of this guide. So, just click on the “Next<\/em>” button to continue. We’re almost done!<\/p>\n\n\n\n
![\"View](\"https:\/\/linuxiac.com\/wp-content\/uploads\/2023\/10\/jellyfin-conf07-1024x744.jpg\")
<\/a>View the added directories.<\/figcaption><\/figure>\n\n\n\n Choose the language you prefer to retrieve metadata for library media content and click “Next<\/em>.”<\/p>\n\n\n\n
![\"Choose](\"https:\/\/linuxiac.com\/wp-content\/uploads\/2023\/10\/jellyfin-conf08-1024x744.jpg\")
<\/a>Choose the preferred metadata language.<\/figcaption><\/figure>\n\n\n\n We strongly recommend leaving “Allow remote connections to this server<\/em>” checked on the next screen. Otherwise, you won’t be able to connect other devices, such as your phone, tablet, smart TV, etc., to the Jellyfin server.<\/p>\n\n\n\n
![\"Set](\"https:\/\/linuxiac.com\/wp-content\/uploads\/2023\/10\/jellyfin-conf09-1024x744.jpg\")
<\/a>Set up remote access.<\/figcaption><\/figure>\n\n\n\n And that’s it – we’re ready! Click the “Finish<\/em>” button to complete and save the settings you made to the Jellyfin server.<\/p>\n\n\n\n
![\"Completing](\"https:\/\/linuxiac.com\/wp-content\/uploads\/2023\/10\/jellyfin-conf10-1024x744.jpg\")
<\/a>Completing the Jellyfin server setup.<\/figcaption><\/figure>\n\n\n\n You will be redirected to a screen to login to your Jellyfin server. Enter the admin username and password you created earlier and hit “Sign In<\/em>.”<\/p>\n\n\n\n
![\"Log](\"https:\/\/linuxiac.com\/wp-content\/uploads\/2023\/10\/jellyfin-conf11-1024x671.jpg\")
<\/a>Log in to the server.<\/figcaption><\/figure>\n\n\n\n The dashboard of your brand new Jellyfin server will welcome you, and as we can see, our “Movies<\/em>” library is there. You can click on it to explore its content.<\/p>\n\n\n\n
![\"Jellyfin](\"https:\/\/linuxiac.com\/wp-content\/uploads\/2023\/10\/jellyfin-conf12-1024x667.jpg\")
<\/a>Jellyfin media server successfully installed using Docker Compose.<\/figcaption><\/figure>\n\n\n\n Add, Edit, Remove Media Libraries<\/h2>\n\n\n\n
Click the hamburger menu in the upper left corner of the screen and choose “Dashboard<\/em>” from the list of options to add, edit, and remove a library from the Jellyfin server.<\/p>\n\n\n\n
Then, choose “Libraries<\/em>” from the left and hit the “+<\/em>” button to add a new one. To edit the settings of an existing one or remove it, use the icon with the three vertical dots on it.<\/p>\n\n\n\n
![\"Add,](\"https:\/\/linuxiac.com\/wp-content\/uploads\/2023\/10\/jellyfin-conf14-1024x706.jpg\")
<\/a>Add, edit, and remove media libraries.<\/figcaption><\/figure>\n\n\n\n Jellyfin Client Applications<\/h2>\n\n\n\n
To install and connect to your Jellyfin media server, click this link<\/a> to get the client apps for various devices, including smartphones, tablets, and smart TVs.<\/p>\n\n\n\n
Conclusion<\/h2>\n\n\n\n
And there you have it – a powerful, flexible, and open-source media server at your fingertips, ready to stream content to all your devices. Remember, the beauty of this setup is that it is entirely yours to customize, explore, and expand as your media collection grows and evolves.<\/p>\n\n\n\n
As you can see, deploying the Jellyfin media server with Docker Compose simplifies the installation and management of the media server, making it accessible and easy to set up.<\/p>\n\n\n\n
We highly recommend you check out our “How to Install and Use Docker Compose<\/a>” guide to familiarize yourself with the basic Docker Compose commands and easily manage your new Jellyfin deployment.<\/p>\n\n\n\n
Furthermore, if you’re wondering, “OK, but how can I update the Jellyfin container when a new version comes out?” there’s no room for worry. We\u2019ve got you covered! With the help of Watchtower and our detailed and easy-to-follow guide, \u201cWatchtower: Automatically Update Docker Container Images<\/a>,\u201d you\u2019ll always have the most up-to-date Jellyfin version.<\/p>\n\n\n\n
- How to Install Docker on Debian 12 (Bookworm)<\/a><\/li>\n\n\n\n