Mastering Jellyfin on Raspberry Pi in 2023 - A Comprehensive Step-By-Step Guide


What is covered in this guide

  • Introduction: An introduction to the blog post, outlining what Jellyfin and Raspberry Pi are, their functions, and why you might want to run Jellyfin on Raspberry Pi. The section will also highlight the practical benefits of setting up Jellyfin on Raspberry Pi.
  • What is Raspberry Pi?: A comprehensive discussion of Raspberry Pi, its features, components, different models, and various applications, specifically its capability to run media servers like Jellyfin.
  • What is Jellyfin?: An in-depth look into Jellyfin, an open-source media system, explaining what it does, how it works, and why Raspberry Pi is an ideal device for running it.
  • Setting Up Your Raspberry Pi:
    • Hardware Requirements: A detailed list of all the necessary equipment required to prepare your Raspberry Pi to run Jellyfin.
    • Installing Raspberry Pi OS: A step-by-step guide on how to install the Raspberry Pi Operating System.
  • Setting Up Jellyfin on Raspberry Pi:
    • Installing Jellyfin: Detailed instructions on how to install and configure Jellyfin on your Raspberry Pi.
    • Setting Up Media Libraries: Guide on how to organize and configure your media files for access through Jellyfin.
    • Configuring Users and Permissions: Explanation of how to set up user accounts and permissions for accessing your media content on Jellyfin.
  • Accessing Your Jellyfin Server:
    • Local Access: A walkthrough on how to access your Jellyfin media server on your local network.
    • Remote Access: Step-by-step guide on how to access your Jellyfin server from outside your local network.
  • Securing Your Jellyfin Server:
    • Setting Up Security Features: Tips on how to secure your Jellyfin server, including enabling HTTPS, regular updates, and changing default settings.
    • Port Forwarding: A guide on how to set up port forwarding for secure remote access to your Jellyfin server.
  • Troubleshooting and FAQs: Address some common problems that beginners might encounter when setting up Jellyfin on a Raspberry Pi and provide solutions, as well as answer frequently asked questions.
  • Resources for Further Learning: Recommend resources (websites, books, online courses, communities) for additional learning about Jellyfin, Raspberry Pi, and media servers.
  • Conclusion: A summary of the guide, encouraging the reader to explore the capabilities of Raspberry Pi and Jellyfin further. This section will also reiterate the practical benefits and enjoyment derived from setting up your own media server.


Welcome to our comprehensive guide to mastering Jellyfin on Raspberry Pi in 2023. As media consumption habits continue to evolve, many of us seek flexibility, control, and freedom when it comes to accessing our favourite movies, shows, music, and other media. That's where solutions like Jellyfin and Raspberry Pi come in.

Firstly, let's get to know what Jellyfin and Raspberry Pi are, and why this combination can be a game-changer for your media consumption experience.

Jellyfin is an open-source media server software. It lets you organize, manage, and stream your media collection, whether it's movies, TV shows, music, or even eBooks, from a centralized server to a variety of devices. These can include your PC, smartphone, smart TV, or any other device that supports media streaming. Jellyfin's powerful transcoding capabilities mean it can deliver media in the optimal format and quality for each device, ensuring the best possible playback experience. Unlike some other media servers, Jellyfin is entirely free and open-source, which means it's not only cost-effective, but it's also constantly evolving and improving through the contributions of its active developer community.

On the other hand, the Raspberry Pi is a tiny yet mighty computer that has taken the world by storm. Its power, flexibility, and affordability have made it a popular choice for a vast array of applications, from robotics and home automation to web servers and gaming consoles. With a Raspberry Pi, you can do virtually anything a regular computer can do, but at a fraction of the size, cost, and power consumption. Moreover, it's open-source nature and the vast, enthusiastic community behind Raspberry Pi have led to an abundance of software, tutorials, and project ideas, making it accessible even to complete beginners in computing.

So why should you consider running Jellyfin on Raspberry Pi? Here's why: Raspberry Pi's low cost and energy efficiency make it a cost-effective choice for a server that may be running 24/7. Its small size means it can fit almost anywhere, even if space is at a premium. Meanwhile, Jellyfin's ability to organize and stream your media collection can turn your Raspberry Pi into a powerful media server, allowing you to access your media anytime, anywhere.

With Jellyfin on Raspberry Pi, you can create a personal Netflix-like server, but with more control and fewer restrictions. No more worries about content being removed from streaming services, or about being unable to access your media while travelling. You control what media is available, who can access it, and where and when it can be accessed. Additionally, Jellyfin's user-friendly interface and powerful features like on-the-fly transcoding and live TV support can enhance your media experience.

Whether you're a seasoned Raspberry Pi user looking to explore new applications, or a movie buff wanting more control over your media collection, setting up Jellyfin on Raspberry Pi can be a rewarding project. Not only will it challenge you to learn new skills and solve problems, but at the end of it, you'll have your own personal media server, tailored to your needs and preferences. This guide will take you through the process step-by-step, making it accessible even if you're new to Raspberry Pi or media servers. Let's get started!

What is Raspberry Pi?

Raspberry Pi is an incredible piece of technology that has spurred innovation and creativity among tech enthusiasts, students, and professionals alike since its debut in 2012. Designed and developed by the UK-based Raspberry Pi Foundation, it is a single-board computer the size of a credit card, but don't let its small size fool you. This mighty miniature device packs quite a punch.

At its core, Raspberry Pi consists of a system-on-chip (SoC) that includes a processor, graphics unit, and memory. It also has a variety of interfaces and connectors for peripherals such as a mouse, keyboard, and monitor. Standard features include USB ports, an HDMI output, a microSD card slot for storage, and Ethernet and Wi-Fi for network connectivity. It also has a General Purpose Input/Output (GPIO) header that enables it to interact with a wide range of hardware components, enabling its use in a myriad of electronic projects.

The Raspberry Pi comes in a few different models, each catering to a different set of needs. The models as of my knowledge cutoff in September 2021 are the Raspberry Pi 4 Model B, the Raspberry Pi 3 Model B+, the Raspberry Pi 3 Model A+, and the Raspberry Pi Zero (and Zero W). The main differences between these models lie in their processing power, memory, connectivity options, and physical size. The Raspberry Pi 4 Model B is the most powerful variant as of my knowledge cutoff, capable of performing intensive tasks with up to 8GB of RAM. On the other hand, the Raspberry Pi Zero is the smallest and most affordable model, offering reduced processing power and connectivity in a tiny form factor that's perfect for space-constrained projects.

Raspberry Pi can run a variety of operating systems, most notably Raspberry Pi OS, which is a Debian-based Linux distribution specifically optimized for the Raspberry Pi. Other popular options include Ubuntu, LibreELEC, and even a version of Windows 10 IoT Core.

The applications of Raspberry Pi are limited only by your imagination. From simple beginnings as a device to teach computer science, Raspberry Pi has found its place in everything from robotics to digital signage, home automation, web servers, and even space exploration. The Raspberry Pi's power and flexibility combined with its low cost and energy consumption make it an ideal choice for DIY projects and educational purposes.

One popular application for Raspberry Pi is as a media server, and that's where Jellyfin enters the picture. The Raspberry Pi, particularly the more powerful models like the Raspberry Pi 4 Model B, is capable of running media server software like Jellyfin. This turns your Raspberry Pi into a centralized hub for your media collection, allowing you to organize and stream your media to various devices on your network and even outside your network if configured accordingly.

Running Jellyfin on a Raspberry Pi has several benefits. It's energy-efficient, so you can keep it running 24/7 without worrying about a hefty electricity bill. It's also quiet, compact, and easy to set up and manage, making it an excellent choice for home use.

Whether you're a tech enthusiast wanting to create a home media server, a student learning about computers, or a professional developing a new IoT device, Raspberry Pi offers a powerful, flexible, and cost-effective platform. This guide will help you explore one of the many potential applications of Raspberry Pi - creating a personal media server using Jellyfin.

What is Jellyfin?

As our digital world evolves, our media consumption habits have dramatically changed. This shift led to the advent of media server software platforms like Jellyfin. Jellyfin is a free and open-source media system that lets you organize, control, and share your media files from a central location. It opens up a whole new world of possibilities for your media collection and how you access it.

So, what exactly does Jellyfin do? At its core, Jellyfin allows you to create your own personal media server. Imagine having a Netflix-like system, but you control the content, the viewers, and the viewing policies. You can store movies, TV shows, music, and even eBooks on your Jellyfin server and then stream them to your devices, whether they are TVs, computers, or smartphones.

The magic of Jellyfin is its ability to transcode media files on-the-fly. This means it automatically converts the media file to a format and quality suitable for the device you're streaming it to. If you're streaming a high-definition movie to your 4K smart TV, Jellyfin will deliver it in full quality. But if you're streaming the same movie to your smartphone over a limited data connection, Jellyfin can reduce the quality to save data, all without any manual intervention.

Jellyfin also supports multiple users and user management. Each user can have their own personalized media library, view progress, and parental control settings. Moreover, it provides features like live TV support and DVR capabilities when paired with a compatible TV tuner.

One of the most appealing aspects of Jellyfin is its status as open-source software. This means its source code is freely available to everyone, allowing users to modify, improve, and distribute the software. It also means there are no hidden features or tracking, giving you total control over your data.

Jellyfin can run on a variety of platforms, including Windows, macOS, Linux, and Docker. And this brings us to Raspberry Pi, a popular device for running Jellyfin.

Why is Raspberry Pi an ideal device for running Jellyfin? There are several reasons.

First, Raspberry Pi is affordable and energy-efficient. Running a server 24/7 can be costly in terms of energy use, but Raspberry Pi consumes far less power than a typical computer, making it cost-effective for a home media server.

Second, Raspberry Pi's compact size and quiet operation make it suitable for home use, where a noisy, space-consuming server might not be welcome. You can tuck your Raspberry Pi Jellyfin server away in a corner, and you'll barely know it's there.

Third, despite its small size, Raspberry Pi is powerful enough to run Jellyfin and serve media to multiple devices. The latest models, like the Raspberry Pi 4 Model B, come with up to 8GB RAM and a quad-core processor, which are more than sufficient for running Jellyfin.

Finally, Raspberry Pi's vibrant community and wealth of online resources make it easy for even beginners to set up and manage a Jellyfin server. You'll find plenty of guides, tutorials, and forums where you can get help and share your experiences.

In summary, Jellyfin offers a powerful and flexible solution for managing and streaming your media collection, while Raspberry Pi provides an affordable, efficient, and capable platform for running Jellyfin. Together, they give you the power to create your own personal media server that's tailored to your needs and preferences. This guide will show you how.

Setting Up Your Raspberry Pi: Hardware Requirements

To set up your Raspberry Pi to run Jellyfin, you'll need a selection of hardware components. This section will provide a comprehensive list of the necessary equipment and explain why each component is crucial. Keep in mind that the type and version of Raspberry Pi you use may slightly affect the hardware requirements, but for this guide, we'll base our list on the Raspberry Pi 4 Model B, which has the necessary power to run Jellyfin effectively.

  • Raspberry Pi 4 Model B: The heart of your Jellyfin media server, the Raspberry Pi 4 Model B is the most powerful model available as of my last update in September 2021. It comes with options for 2GB, 4GB, or 8GB of RAM. For the smoothest experience with Jellyfin, especially if you plan to stream high-definition content or serve multiple users simultaneously, I recommend the 4GB or 8GB variants.
  • MicroSD Card: A microSD card will serve as the Raspberry Pi's primary storage, where the operating system and Jellyfin software will be installed. I recommend a high-quality microSD card with at least 32GB of storage, although you might consider a larger one (64GB or more) if you plan to store media files directly on your Raspberry Pi.
  • MicroSD Card Reader: You'll need a microSD card reader to write the Raspberry Pi's operating system onto the microSD card. Most modern laptops have built-in SD card slots, but you may need an external reader if your computer doesn't have one.
  • Power Supply: A Raspberry Pi 4 requires a USB-C power supply with an output of 5V and at least 3A. It's crucial to use a power supply that meets these specifications to ensure stable and reliable operation of your Raspberry Pi.
  • HDMI Cable and Monitor: You'll need an HDMI cable and a monitor to set up and configure your Raspberry Pi. Note that the Raspberry Pi 4 uses a micro-HDMI output, so you'll need a micro-HDMI to HDMI cable, or a standard HDMI cable with a micro-HDMI adapter.
  • Keyboard and Mouse: A USB keyboard and mouse are essential for initial setup and configuration of your Raspberry Pi.
  • Ethernet Cable: Although the Raspberry Pi 4 has built-in Wi-Fi, a wired Ethernet connection is recommended for setting up your Jellyfin media server. This will ensure a stable, high-speed network connection for streaming media.
  • External Storage: While not strictly necessary, you might want to consider an external hard drive or network-attached storage (NAS) device to store your media files. The capacity you'll need depends on the size of your media collection. Remember to choose a drive with fast read and write speeds to ensure smooth streaming.
  • Raspberry Pi Case: Finally, consider getting a case for your Raspberry Pi to protect it from dust and accidental damage. Some cases also come with built-in cooling solutions, which can be beneficial if your Raspberry Pi is working hard serving media.

Once you've gathered all these components, you'll be ready to start setting up your Raspberry Pi to run Jellyfin. The next sections will guide you through the process step-by-step. Remember, setting up a Raspberry Pi might seem challenging if you're new to it, but take your time, follow the instructions carefully, and don't hesitate to seek help from the Raspberry Pi community if you need it. The reward of having your own personal media server will be well worth the effort.

Installing Raspberry Pi OS: A Step-by-Step Guide

In this section, we will guide you through the process of installing the Raspberry Pi OS onto your microSD card. Raspberry Pi OS (formerly known as Raspbian) is the official operating system for Raspberry Pi. It's a variant of the Debian Linux distribution and is optimized for the best performance on Raspberry Pi hardware.

To make the installation process easier, we'll be using the Raspberry Pi Imager, an official tool provided by the Raspberry Pi Foundation. Here's a step-by-step guide to help you navigate through the process.

  1. Download and Install Raspberry Pi Imager: Head over to the official Raspberry Pi downloads page and download the Raspberry Pi Imager for your operating system (Windows, macOS, or Ubuntu). Once downloaded, install the application on your computer.

  2. Insert Your microSD Card: Insert your microSD card into the card reader on your computer. If your computer doesn't have a built-in card reader, you'll need to use an external USB card reader.

  3. Launch Raspberry Pi Imager: Locate the Raspberry Pi Imager on your computer and open it. You'll see a simple interface with a few options.

  4. Choose OS: Click on the "Choose OS" button. This will bring up a list of available operating systems. For this guide, select "Raspberry Pi OS (other)" and then choose "Raspberry Pi OS Lite." The Lite version is a minimal version without a graphical user interface, which is ideal for a server setup like we're doing with Jellyfin.

  5. Select microSD Card: After choosing the OS, click on the "Choose SD Card" button and select your microSD card from the list.

  6. Write: Once you've selected the OS and the microSD card, click the "Write" button. The Raspberry Pi Imager will download the selected OS (if not already downloaded) and write it onto the microSD card. This process can take some time, depending on your internet speed and the write speed of your microSD card.

  7. Wait: Wait for the writing process to complete. Raspberry Pi Imager will display a progress bar so you can see how far along the process is. Once the writing process is complete, the application will automatically verify the data to ensure everything was written correctly.

  8. Eject the microSD Card: After the verification process, Raspberry Pi Imager will let you know that the microSD card can now be removed. Safely eject the microSD card from your computer.

Congratulations! You have successfully written the Raspberry Pi OS to your microSD card.

The next step is to insert the microSD card into your Raspberry Pi and boot it up. Make sure to connect all the necessary peripherals - your monitor, keyboard, mouse, and Ethernet cable - before you plug in the power.

On first boot, the Raspberry Pi will start up in the command line interface. You'll need to log in using the default username ("pi") and password ("raspberry"). You're now ready to configure your Raspberry Pi and install Jellyfin. The upcoming sections of this guide will take you through these processes in detail.

Remember, don't be discouraged if things don't work perfectly the first time. Learning is part of the process, and the Raspberry Pi community is always there to help if you encounter any problems. Soon, you'll have your Jellyfin media server up and running on your Raspberry Pi.

Setting Up Jellyfin on Raspberry Pi: Installing Jellyfin

In this section, we'll guide you on how to install and configure Jellyfin on your Raspberry Pi. Jellyfin is a powerful open-source media server software that lets you organize, manage, and stream your media collection across multiple devices. It's the perfect tool to transform your Raspberry Pi into a home media hub. Let's get started.

  1. Update Your Raspberry Pi

Before installing Jellyfin, it's a good idea to update your Raspberry Pi to the latest software. In the Raspberry Pi command line interface, type the following commands:

sudo apt-get update
sudo apt-get upgrade

The first command updates the list of available packages, while the second upgrades all your installed packages to their latest versions. Depending on your internet speed, this process might take a few minutes.

  1. Add the Jellyfin Repository

Jellyfin has an official Debian repository that we'll use to install the software. First, we need to add the repository to our system. Type the following commands:

sudo apt install apt-transport-https
wget -O - | sudo apt-key add -
echo "deb [arch=$(dpkg --print-architecture)]$(awk -F'=' '/^ID=/{ print $NF }' /etc/os-release) $(awk -F'=' '/^VERSION_CODENAME=/{ print $NF }' /etc/os-release) main" | sudo tee /etc/apt/sources.list.d/jellyfin.list

These commands download the Jellyfin GPG key, which is used to verify that the software you're installing is indeed from Jellyfin and hasn't been tampered with. It then adds the Jellyfin repository to your system.

  1. Install Jellyfin

Now that the Jellyfin repository is added, we can install Jellyfin with the following commands:

sudo apt update
sudo apt install jellyfin

Again, the first command updates the list of available packages, this time including the Jellyfin repository we just added. The second command installs Jellyfin.

During the installation, you'll be asked to configure some settings for Jellyfin, including the network ports to use and the user to run the Jellyfin service. The defaults should work fine for most users.

  1. Start Jellyfin

Once Jellyfin is installed, you can start the service with the following command:

sudo systemctl start jellyfin
  1. Access Jellyfin

At this point, Jellyfin should be running on your Raspberry Pi. You can access the Jellyfin web interface from any device on your local network. Open a web browser and type the following address, replacing "raspberrypi" with the local IP address of your Raspberry Pi if necessary:


You should see the Jellyfin welcome screen, which will guide you through the initial setup process. Here you can create a user, configure your media libraries, adjust playback settings, and more.

Congratulations! You now have Jellyfin running on your Raspberry Pi. In the next sections, we'll dive deeper into the configuration options of Jellyfin and how to get the most out of your new Raspberry Pi media server.

Setting Up Media Libraries: Organizing and Configuring Media Files for Jellyfin

After installing Jellyfin on your Raspberry Pi, the next step is to configure your media libraries. Jellyfin organizes your media files into libraries, such as Movies, TV Shows, Music, and Photos. Each library corresponds to a folder on your Raspberry Pi's storage device, where you'll store the relevant media files.

Creating and managing libraries in Jellyfin is straightforward. This guide will walk you through the process, along with some tips for organizing your media files for the best experience.

Step 1: Organize Your Media Files

Before creating libraries in Jellyfin, it's a good idea to organize your media files. The structure and naming of your files and folders can impact how Jellyfin identifies and categorizes your media.

For Movies, it's recommended to use a folder structure like /Movies/MovieName (Year)/MovieName (Year).extension. For TV Shows, use /TV Shows/ShowName (Year)/Season 01/ShowName - S01E01 - EpisodeName.extension. Jellyfin uses the filenames and folder structure to fetch metadata like movie posters, plot summaries, and cast lists, so it's worth spending some time getting this right.

Step 2: Add Libraries in Jellyfin

To add a library in Jellyfin, navigate to the Jellyfin web interface on your Raspberry Pi (http://raspberrypi:8096 by default). Click on the user icon in the top right corner, then select Dashboard. On the left side of the Dashboard, click on Libraries under the Server section.

To create a new library, click on the + button. This will open the Add Media Library page. Here you can select the Content type (like Movies, TV Shows, or Music), give the library a Display name, and add Folders that contain the media files for this library.

To add a folder, click on the + button next to Folders. Navigate to the location of your media files on your Raspberry Pi and select the folder. Click OK to add the folder to the library.

Step 3: Configure Library Settings

In the Add Media Library page, there are additional settings you can configure for your library. These settings control how Jellyfin fetches metadata, displays artwork, and more.

Under Library Options, you can enable or disable Realtime Monitoring, which makes Jellyfin watch for changes in the folder and update the library automatically. If your media collection is large or changes frequently, this is a useful feature to enable.

Under Advanced, you can select the metadata Language and Country, control the Automatic Refresh rate, and set the Preferred Download Language for subtitles.

Once you've configured the settings to your liking, click OK to create the library. Jellyfin will start scanning the folder and fetch metadata for your media files. Depending on the size of your library, this process can take some time.

Step 4: Repeat for Other Libraries

Repeat steps 2 and 3 for each type of media library you want to create. For instance, you might create separate libraries for Movies, TV Shows, and Music, each with their own folder and settings.

And that's it! You've now set up your media libraries in Jellyfin. You can access your libraries from the home page of the Jellyfin web interface. Click on a library to browse your media files, view metadata, play media, and more.

In the next sections of this guide, we'll explore more advanced features of Jellyfin, such as streaming your media to other devices, integrating with online services, and customizing the user interface. But for now, sit back and enjoy your own personal media server!

Configuring Users and Permissions: Setting Up User Accounts on Jellyfin

Jellyfin offers the flexibility of multiple user accounts with varying levels of access to your media library. Whether you want to create accounts for family members, restrict access to certain content, or even keep track of where you left off in a movie, setting up users in Jellyfin is the way to go. This guide will walk you through creating users, setting permissions, and managing user profiles for optimal usage of your Jellyfin media server.

Step 1: Accessing the Dashboard

The first step towards creating and managing user accounts is accessing the Jellyfin dashboard. Open your Jellyfin web interface (http://raspberrypi:8096 is the default address) and click on the user icon at the top right corner. From the dropdown menu, select Dashboard.

Step 2: Creating Users

On the Dashboard sidebar, under the Server section, you'll find the Users tab. Clicking on it will open the Users page where you'll find a list of existing users. To create a new user, click on the + button next to Users.

On the New User page, enter the user's name and, optionally, a password. Setting a password is recommended for privacy and to prevent unauthorized access, especially if your Jellyfin server is accessible outside your home network.

Step 3: Setting User Permissions

After creating a user, you can set their permissions. Click on the username in the Users page to open the User Settings page. Here, you'll find several settings categorized under different tabs.

  • Under the Profile tab, you can set the user's language, enable or disable subtitles by default, and choose the default audio and subtitle language.
  • The My Media tab is where you can set the user's access to media libraries. By default, a new user has access to all libraries, but you can restrict access to certain libraries if needed.
  • Under the Parental Control tab, you can set content restrictions based on ratings. This is particularly useful for accounts intended for children.
  • The Password tab is where you can change the user's password, while the API Keys tab is where you can create API keys for this user.

Step 4: Configuring User Policy

In the User Settings page, there's another category named Policy. This is where you can control a user's access to Jellyfin's features.

  • Under the Access section, you can control the user's ability to delete media, download media, sync media to other devices, and more.
  • The Live TV section is where you can allow or disallow the user to access live TV features.
  • Under Subtitles, you can control whether the user can download subtitles or burn them into videos.
  • Lastly, the Advanced section is where you can restrict the user's ability to administer the Jellyfin server and access advanced features.

Step 5: Repeat for Other Users

Repeat steps 2-4 for each user you want to create. With individual user accounts, each user will have their own watch history, recommendations, and settings, providing a personalized experience for everyone using your Jellyfin media server.

And that's it! You've now mastered how to set up user accounts and permissions on Jellyfin. This adds an extra layer of personalization and security to your media server. In the next sections, we'll look at how to access your Jellyfin server from different devices, and how to secure your server if you choose to make it accessible over the internet.

Accessing Your Jellyfin Server: Local Access

Once you've set up Jellyfin on your Raspberry Pi and configured your media libraries, you're probably eager to start enjoying your media collection. In this section, we'll walk through how to access your Jellyfin media server on devices within your local network. Whether you're using a laptop, a tablet, a smartphone, or a smart TV, the steps we'll cover here will help you connect to Jellyfin and start streaming your media.

Step 1: Determine Your Raspberry Pi's IP Address

To access your Jellyfin server, you'll first need to know the IP address of your Raspberry Pi within your local network. If you haven't noted it down already, you can find this information through the terminal on your Raspberry Pi.

Open a terminal and type the following command: hostname -I. This command will display your Raspberry Pi's local IP address.

Step 2: Accessing Jellyfin on a Web Browser

Jellyfin has a web interface that can be accessed from any device with a web browser, such as a laptop or a desktop computer. Simply open a web browser and type your Raspberry Pi's local IP address followed by the port number for Jellyfin, which is 8096 by default. The format should look like this: http://<Your Raspberry Pi IP Address>:8096.

For example, if your Raspberry Pi's IP address is, you would type into your web browser. This should bring up the Jellyfin login screen, where you can enter the username and password for the user account you want to use.

Step 3: Accessing Jellyfin on Mobile Devices

For smartphones and tablets, Jellyfin provides dedicated apps for Android and iOS. Simply search for "Jellyfin" in your device's app store and install the app.

Once you've installed the Jellyfin app, open it and you'll be prompted to enter the server details. Again, this will be your Raspberry Pi's local IP address followed by :8096, e.g., After entering the server details, you'll be taken to the login screen to enter your user credentials.

Step 4: Accessing Jellyfin on Smart TVs

For smart TVs, Jellyfin supports a variety of platforms including Android TV, Fire TV, and others through DLNA. If your TV has a web browser, you can also use the web interface method as outlined in Step 2.

For Android TV and Fire TV, you can download the Jellyfin app from the respective app store. Once installed, enter the server details and user credentials as described in the previous steps.

If your TV supports DLNA, make sure DLNA is enabled in Jellyfin's settings (you can find this under Dashboard > DLNA in the web interface). On your TV, search for DLNA devices and select your Jellyfin server. No login is required for DLNA access, but access will be limited to the DLNA user settings in Jellyfin.

And that's it! You should now be able to access your Jellyfin server from any device on your local network. Enjoy browsing your media library and streaming your favorite movies, TV shows, and music. In the next sections, we'll cover remote access to your Jellyfin server, advanced customization options, and troubleshooting tips for common issues. Stay tuned!

Remote Access: Connecting to Your Jellyfin Server from Outside Your Local Network

After setting up your Jellyfin media server on your Raspberry Pi and accessing it within your local network, you may be wondering if you can access your media collection while you're away from home. The answer is yes! With some additional setup, you can access your Jellyfin server from anywhere with an internet connection.

In this section, we'll walk you through how to set up remote access for your Jellyfin server. This involves configuring your router for port forwarding and securing your server with an SSL certificate. This way, you can enjoy your media library whether you're at a friend's house, at the office, or even halfway around the world.

Step 1: Set Up Port Forwarding

To make your Jellyfin server accessible from outside your local network, you'll need to set up port forwarding on your router. This directs incoming traffic on a specific port to your Raspberry Pi.

The exact steps for setting up port forwarding will depend on your router's model and firmware. However, the general steps involve logging into your router's admin interface (usually through a web browser), finding the port forwarding settings, and creating a new rule.

For the new rule, you'll need to enter the following information:

  • Service Name: You can name this "Jellyfin" for easy reference.
  • Port Range: Enter "8096", which is Jellyfin's default port.
  • Local IP: Enter your Raspberry Pi's local IP address.
  • Local Port: Enter "8096".
  • Protocol: Set to "TCP".

Once you've created the rule, save your changes and restart your router if necessary.

Step 2: Determine Your Public IP Address

Next, you'll need to know your public IP address. This is the address you'll use to connect to your Jellyfin server from outside your local network. There are many online tools to find your public IP address. One such tool is the website

Step 3: Accessing Jellyfin Remotely

Now, you should be able to access your Jellyfin server from outside your local network. On your remote device, open a web browser or the Jellyfin app and enter your public IP address followed by :8096, similar to how you accessed the server locally.

Step 4: Securing Your Connection with HTTPS

While your Jellyfin server is now accessible remotely, your connection is not yet secure. To secure your connection, you should set up HTTPS using an SSL certificate. One way to get a free SSL certificate is through Let's Encrypt.

Setting up HTTPS involves installing Certbot on your Raspberry Pi, using it to obtain a certificate from Let's Encrypt, and then configuring Jellyfin to use the certificate. This is a complex process that involves several steps, which are beyond the scope of this guide. We recommend consulting Jellyfin's documentation or a detailed guide specifically for setting up HTTPS.

After setting up HTTPS, you'll access your Jellyfin server using https:// followed by your public IP address and :8096.

And that's it! You've now set up remote access for your Jellyfin media server. You can enjoy your media collection from anywhere with an internet connection, knowing that your connection is secure. In the next sections, we'll cover advanced customization options for Jellyfin and provide troubleshooting tips for common issues. Happy streaming!

Securing Your Jellyfin Server: Setting Up Security Features

Setting up a Jellyfin media server on your Raspberry Pi is an exciting project that opens up a whole new world of media streaming capabilities. However, with this power comes the responsibility of ensuring that your server is secure. If left unprotected, your server could become a target for cyber-attacks. Luckily, there are several steps you can take to secure your Jellyfin server, including enabling HTTPS, performing regular updates, and changing default settings. In this section, we will walk you through each of these security features.

Step 1: Enabling HTTPS

One of the most essential steps in securing your Jellyfin server is enabling HTTPS. As mentioned earlier, HTTPS encrypts the data being sent between your server and the devices you're streaming to, helping to protect your information from being intercepted or tampered with.

To enable HTTPS, you will need a SSL certificate. One way to obtain a free SSL certificate is through Let's Encrypt, which offers free, automated SSL certificates. You will need to install Certbot on your Raspberry Pi, use it to get a certificate from Let's Encrypt, and then configure Jellyfin to use that certificate.

The process of obtaining a SSL certificate and enabling HTTPS can be quite involved and requires a good understanding of command-line interfaces. We recommend consulting Jellyfin's documentation or a detailed guide specifically for setting up HTTPS.

Step 2: Regular Updates

Another crucial security practice is regularly updating your Raspberry Pi's operating system and your Jellyfin server software. Updates often include important security patches that can protect your server from known vulnerabilities.

For Raspberry Pi OS, you can check for updates by opening a terminal and typing the following commands: sudo apt update followed by sudo apt upgrade.

For Jellyfin, the update process will depend on how you installed the software. If you used Jellyfin's official repository, you can update Jellyfin with the same commands as for Raspberry Pi OS. If you used Docker, you can update Jellyfin by pulling the latest image and recreating the container.

Step 3: Changing Default Settings

Finally, one simple but often overlooked step in securing any server is changing the default settings. This includes the default admin account, port number, and any other settings that could be easily guessed by an attacker.

For Jellyfin, we recommend changing the default admin account. You can do this by creating a new admin account, logging in with that account, and then deleting the original admin account.

You can also change the default port number from 8096 to something less predictable. However, keep in mind that you will also need to update the port forwarding rule on your router and your firewall rules, if applicable.

In addition, Jellyfin has several security settings that you can tweak to your liking. These include enabling or disabling certain features, restricting access by IP address, and configuring user permissions. We recommend exploring these settings and tailoring them to your specific needs and risk tolerance.

In conclusion, while setting up a Jellyfin server on a Raspberry Pi is a fun and rewarding project, it's essential to take the time to secure your server. By enabling HTTPS, performing regular updates, and changing default settings, you can protect your server from potential threats and enjoy your media collection with peace of mind. Happy streaming and stay safe!

Port Forwarding: Ensuring Secure Remote Access to Your Jellyfin Server

You've done it! You have successfully set up a Jellyfin server on your Raspberry Pi, configured your media libraries, and even accessed it locally. Now, it's time to take it to the next level - access your server from anywhere in the world. This requires setting up port forwarding on your router to direct incoming connections to your Raspberry Pi. In this section, we will guide you through this process.

Please note, the exact steps for setting up port forwarding can vary widely based on your router's brand and model. Therefore, the following instructions are provided as a general guideline.

Step 1: Identifying Your Raspberry Pi's IP Address

Before you configure your router, you need to know the local IP address of your Raspberry Pi. This is the address your router will need to forward incoming connections to.

You can find your Raspberry Pi's IP address by typing hostname -I in the terminal on your Raspberry Pi. This should return a string of numbers separated by dots (e.g., Make note of this address as you'll need it for port forwarding.

Step 2: Accessing Your Router's Settings

Now you need to access your router's settings. This is typically done by entering the router's IP address into a web browser on a device connected to your network. Common IP addresses for routers are or, but your router's IP address may vary.

Once you've entered the router's IP address, you'll be prompted to enter a username and password. If you haven't changed these from the default, they are often printed on a label on the router itself or provided in your router's documentation.

Step 3: Configuring Port Forwarding

Inside your router's settings, look for the port forwarding settings. These may be under a section called 'Advanced Settings' or 'Security'.

Once you've found the port forwarding settings, you'll need to create a new rule. Although the specific fields you need to fill in may vary, you'll typically need to provide the following information:

  • Service Name/ Application Name: This is for your reference and doesn't affect the rule's functionality. You could name it "Jellyfin".
  • Port Range/ External Port: This is the port number that you want to open for incoming connections. Jellyfin's default port is 8096.
  • Internal IP Address/ LAN IP: This is the local IP address of your Raspberry Pi that you found in step 1.
  • Internal Port/ LAN Port: This is the port that the Raspberry Pi is listening on. Again, this should be 8096, the default port for Jellyfin.
  • Protocol: This refers to the network protocol to be used. You should select "TCP".

Once you've entered these details, save your changes.

Step 4: Testing Your Setup

Now that you've set up port forwarding, you should test whether it's working. You can do this by accessing your Jellyfin server from a device outside your local network. You'll need to enter your public IP address followed by the port number (e.g., in a web browser.

Step 5: Setting up Dynamic DNS (Optional)

One last consideration is that your public IP address may change periodically. This is common if your Internet Service Provider (ISP) uses dynamic IP addresses. To avoid having to check and update your IP address, you can use a Dynamic DNS (DDNS) service, which will provide a stable domain name that updates automatically with your IP address changes.

Remember, setting up port forwarding exposes your server to the internet, which comes with certain security risks. Therefore, it's crucial to follow good security practices, such as using a strong, unique password for Jellyfin, keeping your software up-to-date, and enabling HTTPS. Happy and safe streaming!

Troubleshooting and FAQs: Solving Common Problems and Addressing Your Queries

Like any tech project, setting up Jellyfin on a Raspberry Pi can sometimes be a tricky process, especially for beginners. You may encounter issues or have questions that aren't addressed in the main guide. To help with that, we've compiled some of the most common problems and frequently asked questions about the Jellyfin and Raspberry Pi setup process.


Problem 1: My Raspberry Pi isn't booting up.

A Raspberry Pi failing to boot up can be due to several reasons, including insufficient power supply, a problem with the SD card, or issues with the Raspberry Pi itself.

Solution: Firstly, ensure that your power supply is adequate; a Raspberry Pi typically requires a power supply of at least 2.5A. If the power supply seems fine, check your microSD card. Ensure it's properly formatted and that the Raspberry Pi OS has been correctly written to it. If these don't resolve your issue, it might be worth trying with a different Raspberry Pi, if one is available.

Problem 2: I can't access Jellyfin from other devices on my network.

This could be due to firewall settings, IP address issues, or problems with the Jellyfin server itself.

Solution: Start by checking the IP address of your Raspberry Pi and ensure that you're using the correct address. Also, verify that your firewall isn't blocking access to Jellyfin. If these solutions don't work, there might be an issue with the Jellyfin installation. Try restarting the Jellyfin server or, if necessary, reinstalling it.

Problem 3: My media files aren't showing up in Jellyfin.

This could be a problem with the way your media libraries are set up in Jellyfin, or an issue with file permissions.

Solution: Double-check your media libraries in Jellyfin and ensure the paths are correct. If your libraries are set up correctly, it could be an issue with file permissions. You'll need to ensure that the 'jellyfin' user has the necessary permissions to read your media files.


Question 1: Can I use a Raspberry Pi Zero W for this project?

While it is technically possible to run Jellyfin on a Raspberry Pi Zero W, we wouldn't recommend it. The Raspberry Pi Zero's limited processing power may result in slow loading times and buffering issues when streaming media.

Question 2: Can I use an external hard drive to store my media files?

Absolutely! In fact, an external hard drive is a great way to store large media libraries. Just ensure that your hard drive is formatted in a file system that the Raspberry Pi can read (such as FAT32 or NTFS), and that you mount the hard drive correctly on your Raspberry Pi.

Question 3: Can I stream media from my Jellyfin server over the internet?

Yes, you can! To do this, you'll need to set up port forwarding on your router, as described in the 'Remote Access' section of this guide. Remember, though, that streaming over the internet will use up your home network's upload bandwidth and could result in additional data usage charges from your internet service provider.

We hope this troubleshooting guide and FAQs have helped clear up any lingering questions or issues. If you continue to face problems or have more questions, don't hesitate to refer to the Jellyfin and Raspberry Pi communities online. Happy streaming!

Resources for Further Learning: Expand Your Knowledge on Jellyfin, Raspberry Pi, and Media Servers

This guide has provided you with a comprehensive understanding of setting up and configuring a Jellyfin media server on a Raspberry Pi. But, the world of Raspberry Pi, Jellyfin, and media servers is vast and continually evolving. To help you explore this fascinating universe further, here are some excellent resources, including websites, books, online courses, and communities that can be instrumental for your continued learning journey.


  • The Official Raspberry Pi Website: An invaluable resource with tutorials, project ideas, news about the latest Raspberry Pi products, and a blog featuring fascinating projects from the Raspberry Pi community.
  • The Official Jellyfin Website: The go-to place for all things Jellyfin, including comprehensive documentation covering everything from installation to advanced configuration options.
  • Instructables Raspberry Pi Section: Features numerous Raspberry Pi projects, with step-by-step instructions and helpful pictures.


  • "Raspberry Pi User Guide" by Eben Upton and Gareth Halfacree: Provides an in-depth exploration of Raspberry Pi, making it perfect for beginners and intermediate users alike.
  • "Mastering Media with the Raspberry Pi" by Ralph Roberts: Takes a detailed look at setting up and running various media servers on the Raspberry Pi.
  • "Learning Python with Raspberry Pi" by Alex Bradbury and Ben Everard: A great starting point if you want to delve into coding for the Raspberry Pi.

Online Courses


Remember, learning is a journey, not a destination. So don't be afraid to explore, ask questions, and experiment. Raspberry Pi and Jellyfin offer a world of possibilities, from home media servers to much more. Take your time, and most importantly, enjoy the process!

Conclusion: Mastering Jellyfin on Raspberry Pi, Your Journey Starts Here

As we reach the conclusion of this comprehensive guide, it's important to pause and reflect on what we've accomplished. We started by introducing the basics of Raspberry Pi and Jellyfin. We then dived into the setup and configuration of these two powerful systems, creating a customizable, personal media server. This journey has hopefully provided you with an enriching and rewarding experience, and you're now equipped with a unique tool to enjoy and share your media in a new way.

The Raspberry Pi, a compact and robust microcomputer, brings a world of computational possibilities to the tips of your fingers. On the other hand, Jellyfin, a comprehensive open-source media system, offers an exciting avenue to streamline and organize your media consumption. By integrating Jellyfin with Raspberry Pi, you've not only built a personal media server, but you've also created a springboard for myriad other potential projects, showcasing the extraordinary capabilities of these platforms.

This do-it-yourself approach has practical benefits, such as cost savings and customization options compared to commercial media servers. By using Jellyfin, you can ensure that your personal data remains personal; you are in complete control of your server, without any unwanted third-party interference or tracking. Additionally, the gratification of creating a functional tool from a bare Raspberry Pi board can't be underestimated. It's a testimony to your skills and an achievement to be proud of.

As we step back, it's important to remember that this guide is merely a starting point. The Raspberry Pi and Jellyfin community is innovative and dynamic, with new features, updates, and possibilities being added frequently. With the tools and knowledge you've gained through this guide, you're equipped to continue experimenting, customizing, and expanding your setup. You can add more Raspberry Pi devices, include different types of media, or even venture into different projects like home automation or game servers.

In the process of setting up Jellyfin on Raspberry Pi, you've also gained valuable skills that extend beyond this particular project. You've honed your technical problem-solving skills, learned about networking and server setup, and you might have even dipped your toes into the world of coding. These are all immensely useful skills in our increasingly digital world.

We hope that this guide has sparked a curiosity and enthusiasm that encourages you to explore further. Remember, in the world of Raspberry Pi and open-source software, the only limit is your imagination. The resources provided in the previous section will be your companions as you continue this journey.

As you embark on this exciting path, remember to share your knowledge, experiences, and creations. The Raspberry Pi and Jellyfin communities thrive on the shared enthusiasm and collective problem-solving of its members. By contributing your own discoveries and solutions, you help these communities continue to grow and innovate.

Ultimately, the goal is to enjoy the process. Whether it's the joy of watching your favorite movie from your personal server, the satisfaction of solving a challenging problem, or the excitement of sharing your setup with friends and family, there's plenty of enjoyment to be derived from setting up your own media server. So go forth, continue to learn, experiment, and most importantly, have fun with your new Jellyfin media server on Raspberry Pi. Happy streaming!