What Jellyfin is and why you'd install it on Kali
Jellyfin is free software that turns your computer into a personal media server — it stores movies, TV shows, music, and photos on your machine and lets you watch them from other devices on your network or from outside your home. You install it on Kali Linux the same way you install any other process: by adding Jellyfin's software repository to your system, then using the package manager to read and set up the files.
Kali Linux is a security-focused operating system built on Debian. Jellyfin runs on Debian-based systems without special configuration, which means the installation process is straightforward if you know where to type the commands. This guide walks you through each step in order, explaining what happens at each stage so you know whether something went wrong.
You will need a computer running Kali Linux with internet access, about 500 MB of free disk space for Jellyfin itself (plus storage for your media files), and basic comfort opening a terminal and typing commands. If you have never used the terminal before, this is a good first project — the commands are copy-paste and the feedback is clear.
Key Takeaways
- Jellyfin installs from the official Jellyfin repository, which you add to your system first, then install using apt.
- The installation takes about five to ten minutes and requires you to open a terminal and run four or five commands in sequence.
- After installation, Jellyfin runs as a background service and you access it through a web browser at http://localhost:8096.
- You will need to add your media files to Jellyfin's library folder and configure which folders it should watch before you can watch anything.
- Jellyfin uses very little CPU and memory once it is running, so it can stay on a spare computer or run alongside other services.
Adding the Jellyfin repository to your system
Before you can install Jellyfin, you need to tell your package manager where to find it. Kali Linux uses apt, which downloads software from repositories — curated lists of programs hosted on servers. Jellyfin maintains its own repository, and adding it takes two commands.
Open a terminal. Type this command and press Enter:
curl https://repo.jellyfin.org/install-debuntu.sh | sudo bash
This command downloads a setup script from Jellyfin's server and runs it with administrator privileges (sudo). The script adds Jellyfin's repository to your system's list of sources and imports the key that verifies the software is genuine. You will see text scroll past — this is normal. Wait for the command prompt to return.
If you see an error message saying "curl: command not found", you need to install curl first. Type sudo apt install curl and press Enter, wait for it to finish, then run the Jellyfin command again.
Installing Jellyfin with apt
Once the repository is added, installing Jellyfin itself is one command. In the same terminal, type:
sudo apt install jellyfin
Press Enter. The system will show you how much disk space Jellyfin needs (usually around 500 MB) and ask you to confirm by typing y and pressing Enter. The read and installation will take a few minutes depending on your internet speed. You will see progress text as files are downloaded and unpacked.
When the command finishes and the prompt returns, Jellyfin is installed. The system has also created a user account called "jellyfin" that the service runs under, and set up folders where your media files will live. You do not need to do anything with these — they are handled automatically.
Starting Jellyfin and accessing it through your browser
Jellyfin runs as a service, which means it starts automatically when your computer boots and keeps running in the background. To start it now without rebooting, type:
sudo systemctl start jellyfin
Press Enter and wait a few seconds. The service will start. You can check that it is running by typing:
sudo systemctl status jellyfin
You should see text that says "active (running)" in green. If you see "inactive (dead)" in red, something went wrong — scroll up in the terminal to see if there is an error message, or try the start command again.
Once Jellyfin is running, open a web browser on the same computer and go to http://localhost:8096. You should see the Jellyfin setup page with a welcome screen. This confirms the service is working. If the page does not load, wait 10 seconds and refresh — Jellyfin can take a moment to fully start up.
Completing the initial setup wizard
The setup wizard walks you through creating an admin account and configuring basic settings. You will see screens asking for a username and password — these are for your Jellyfin account, not your Kali Linux login. Create a strong password and write it down, because you will need it to log in later.
The wizard will ask you to select your preferred language and choose a display name for your server. These are optional but helpful if other people will use your Jellyfin server. You can change them later, so do not worry about getting them perfect now.
When the wizard asks about media libraries, you can skip this for now — you will add your media folders in the next section. Click through to the end of the wizard. Once you finish, you will be logged into Jellyfin and see the main dashboard, which is mostly empty because you have not added any media yet.
Adding your media files to Jellyfin
Jellyfin stores media in specific folders on your computer. The default location is /var/lib/jellyfin/media, but you can point Jellyfin to any folder you already have media in. To add a folder, log into Jellyfin in your browser, click the menu icon (three horizontal lines) in the top left, and select Administration.
In the Administration panel, click Libraries on the left side. You will see a button that says Add Media Library. Click it. Choose the type of media you are adding (Movies, TV Shows, Music, or Photos), then click the folder icon to browse to the folder on your computer that contains your files.
Navigate to the folder where your media is stored. If you do not have media files yet, you can create a test folder in your home directory, put a few video files in it, and point Jellyfin there. Once you select the folder, click Add Library. Jellyfin will scan the folder and add any recognized files to your library. This can take a few minutes if you have many files.
Repeat this process for each type of media you want to organize — one library for movies, one for TV shows, and so on. You can add or remove libraries anytime.
Enabling Jellyfin to start automatically on boot
By default, Jellyfin starts automatically when your computer boots. You can verify this is enabled by typing:
sudo systemctl is-enabled jellyfin
If the output says "enabled", you are done — Jellyfin will start every time you restart your computer. If it says "disabled", enable it by typing:
sudo systemctl enable jellyfin
Press Enter. The next time you restart Kali Linux, Jellyfin will start automatically in the background. You can then open your browser and go to http://localhost:8096 to access it, just as you did after the initial installation.
Troubleshooting common installation problems
If Jellyfin does not start or the web page will not load, the most common cause is a port conflict — another service is already using port 8096. You can check what is using the port by typing sudo netstat -tlnp | grep 8096. If something else is using it, you can change Jellyfin's port in the configuration file at /etc/jellyfin/jellyfin.conf, but this requires editing a text file with administrator privileges.
If the installation command fails with a message about "unable to locate package jellyfin", the repository did not add correctly. Run the curl command from the first section again, making sure you copied it exactly. If you still see errors, check that you have internet access and that your Kali Linux system is up to date by running sudo apt update first.
If Jellyfin starts but your media files do not appear in the library, check that the folder path is correct and that the jellyfin user has permission to read the files. You can fix permissions by typing sudo chown -R jellyfin:jellyfin /path/to/media, replacing /path/to/media with the actual folder path.
Frequently Asked Questions
Can I access Jellyfin from outside my home network?
Yes, but it requires additional setup beyond the basic installation. You need to configure port forwarding on your router or use a reverse proxy like Nginx. This is more advanced and outside the scope of this guide, but Jellyfin's documentation covers both methods in detail.
Does Jellyfin work with streaming services like Netflix or Spotify?
No. Jellyfin only plays media files you own or have stored on your computer — it does not stream from other services. It is designed to organize and play your personal library, not to replace subscription services.
How much disk space do I need for Jellyfin?
Jellyfin itself takes about 500 MB. The amount of space you need for media depends entirely on how many movies, shows, and songs you want to store. A single HD movie is typically 4 to 8 GB, so plan accordingly.
Can I run Jellyfin on a Raspberry Pi or other low-power computer?
Yes. Jellyfin runs on any Debian-based system, including Raspberry Pi OS. The installation steps are identical. A Raspberry Pi 4 can handle several simultaneous streams, though older models may struggle with video transcoding.
What if I want to uninstall Jellyfin later?
Type sudo apt remove jellyfin to remove the software. Type sudo apt remove jellyfin-server jellyfin-web if you want to remove the core components separately. Your media files will not be deleted — only the Jellyfin process itself is removed.