Skip to content
Permalink
Branch: master
Find file Copy path
Find file Copy path
Fetching contributors…
Cannot retrieve contributors at this time
346 lines (228 sloc) 13.3 KB
uid title
admin-installing
Installing Jellyfin

Installing

The Jellyfin project and its contributors offer a number of pre-built binary packages to assist in getting Jellyfin up and running quickly on multiple systems.

Containers

Official Docker Hub

Docker Pull Count

The Jellyfin Docker image is available on Docker Hub for multiple architectures.

  1. Get the latest image:
    docker pull jellyfin/jellyfin
  2. Create directories on the host for persistent data storage:
    mkdir /path/to/config
    mkdir /path/to/cache
  3. Start the server:
    docker run -d \
    --volume /path/to/config:/config \
    --volume /path/to/cache:/cache \
    --volume /path/to/media:/media \
    --net=host \
    jellyfin/jellyfin

Alternatively, using docker-compose:

version: "3"  
services:  
    jellyfin:  
      image: jellyfin/jellyfin  
      network_mode: "host"  
      volumes:  
        - /path/to/config:/config  
        - /path/to/cache:/cache  
        - /path/to/media:/media  

Docker Hub maintained by LinuxServer.io

Docker Pull Count

Unraid Docker

An Unraid Docker template is available in the repository.

  1. Open the unRaid GUI (at least unRaid 6.5) and click on the "Docker" tab.

  2. Add the following line under "Template Repositories" and click "Save":
    https://github.com/jellyfin/jellyfin/blob/master/deployment/unraid/docker-templates

  3. Click "Add Container" and select "jellyfin".

  4. Adjust any required paths and save.

Kubernetes

A community project to deploy Jellyfin on Kubernetes-based platforms exists at their repository. Any issues or feature requests related to deployment on Kubernetes-based platforms should be filed there.

Windows (x86/x64)

Windows installers and builds in ZIP archive format are available here.

[!WARNING]

If you installed a version prior to 10.4.0 using a PowerShell script, you will need to manually remove the service using the command nssm remove Jellyfin and uninstall the server by remove all the files manually. Also one might need to move the data files to the correct location, or point the installer at the old location.

[!WARNING]

The 32-bit or x86 version is not recommended. ffmpeg and its video encoders generally perform better as a 64-bit executable due to the extra registers provided. This means that the 32-bit version of Jellyfin is deprecated.

Install using installer (x64)

Only available for versions 10.4.0+.

Install

  1. Download the latest version
  2. Run the installer
  3. (optional) When installing as a service, pick the service account type.
  4. If everything was completed successfully, the Jellyfin service is now running
  5. Open your browser at http://localhost:8096 to finish setting up Jellyfin

Update

  1. Download the latest version
  2. Run the installer
  3. If everything was completed successfully, the Jellyfin service is now running as the new version.

Uninstall

  1. Go to Add or remove programs in Windows
  2. Search for Jellyfin
  3. Click Uninstall

Manual installation (x86/x64)

Install

  1. Download and extract the latest version
  2. Create a folder jellyfin at your preferred install location
  3. Copy the extracted folder into the jellyfin folder and rename it to system
  4. Create jellyfin.bat within your jellyfin folder containing:
    • To use the default library/data location at %localappdata%:
      <--Your install path-->\jellyfin\system\jellyfin.exe
    • To use a custom library/data location (Path after the -d parameter):
      <--Your install path-->\jellyfin\system\jellyfin.exe -d <--Your install path-->\jellyfin\data
    • To use a custom library/data location (Path after the -d parameter) and disable the auto-start of the webapp:
      <--Your install path-->\jellyfin\system\jellyfin.exe -d <--Your install path-->\jellyfin\data -noautorunwebapp
  5. Run jellyfin.bat
  6. Open your browser at http://<--Server-IP-->:8096 (if auto-start of webapp is disabled)

Update

  1. Stop Jellyfin
  2. Rename the Jellyfin system folder to system-bak
  3. Download and extract the latest Jellyfin version
  4. Copy the extracted folder into the jellyfin folder and rename it to system
  5. Run jellyfin.bat to start the server again

Rollback

  1. Stop Jellyfin
  2. Delete the system folder
  3. Rename system-bak to system
  4. Run jellyfin.bat to start the server again

Install using legacy script (x86/x64)

Only for versions 10.3.x and earlier.

  1. Download and extract the latest version
  2. Run install.bat or install-jellyfin.ps1
  3. (optional) Enter a custom install location (default is %appdata%)
  4. (optional) Enter a custom library/data location (default is %localappdata%) - Currently not working
  5. (optional) Select to install Jellyfin as a service
  6. (optional) Import old library - Not compatible with newer Emby versions
  7. (optional) Create a shortcut on your desktop
  8. (optional) Run Jellyfin after installation
  9. Press Install

MacOS

MacOS Application packages and builds in TAR archive format are available here.

Install

  1. Download the latest version.
  2. Drag the .app package into the Applications folder
  3. Start the application
  4. Open your browser at http://localhost:8096

Upgrade

  1. Download the latest version.
  2. Stop the currently running server either via the dashboard or using the application icon.
  3. Drag the new .app package into the Applications folder and click yes to replace the files.
  4. Start the application
  5. Open your browser at http://localhost:8096

Uninstall

  1. Stop the currently running server either via the dashboard or using the application icon.
  2. Move the .app package to the Trash.

Deleting Configuation

This will delete all settings and user information. This Applies for the .app package and the Portable Version.

  1. Delete the folder ~/.config/jellyfin/
  2. Delete the folder ~/.local/share/jellyfin/

Portable Version

  1. Download the latest version
  2. Extract it into the Applications folder
  3. Open Terminal and type cd followed with a space then drag the jellyfin folder into the terminal.
  4. Type ./jellyfin to run jellyfin.
  5. Open your browser at http://localhost:8096

Closing the terminal window will end jellyfin. Running jellyfin in screen or tmux can prevent this from happening.

Upgrading the Portable Version

  1. Download the latest version.
  2. Stop the currently running server either via the dashboard or using CTRL+C in the terminal window.
  3. Extract the latest version into Applications
  4. Open Terminal and type cd followed with a space then drag the jellyfin folder into the terminal.
  5. Type ./jellyfin to run jellyfin.
  6. Open your browser at http://localhost:8096

Uninstalling the Portable Version

  1. Stop the currently running server either via the dashboard or using CTRL+C in the terminal window.
  2. Move /Application/jellyfin-version folder to the Trash. Replace version with the actual version number you are trying to delete.

Using FFmpeg with the Portable Version

The portable version doesn't come with FFmpeg by default. To install FFmpeg you can use homebrew or download the build from Zeranoe (Recommended). If using Zeranoe's build, extract it to the /Applications/ folder. Navigate to Playback tab in the Dashboard and set the path to FFmpeg under FFmpeg Path.

Linux (generic amd64)

Generic amd64 Linux builds in TAR archive format are available here.

Portable DLL

Platform-agnostic .NET Core DLL builds in TAR archive format are available here. These builds use the binary jellyfin.dll and must be loaded with dotnet.

Arch

Jellyfin is not yet available in the official repository but can be found here in the user repository.

Fedora

Fedora 29 builds in RPM package format are available here for now but an official Fedora repository is coming soon.

CentOS

CentOS/RHEL 7 builds in RPM package format are available here and an official CentOS/RHEL repository is planned for the future.

Debian

Repository

The Jellyfin team provides a Debian repository for installation on Debian Stretch/Buster. Supported architectures are amd64, arm64, and armhf.

NOTE: Microsoft does not provide a .NET for 32-bit x86 Linux systems, and hence Jellyfin is not supported on the i386 architecture.

  1. Install HTTPS transport for APT if you haven't already:
    sudo apt install apt-transport-https

  2. Import the GPG signing key (signed by the Jellyfin Team):
    wget -O - https://repo.jellyfin.org/debian/jellyfin_team.gpg.key | sudo apt-key add -

  3. Add a repository configuration at /etc/apt/sources.list.d/jellyfin.list:
    echo "deb [arch=$( dpkg --print-architecture )] https://repo.jellyfin.org/debian $( lsb_release -c -s ) main" | sudo tee /etc/apt/sources.list.d/jellyfin.list

    NOTE: Supported releases are: stretch and buster.

  4. Update APT repositories:
    sudo apt update

  5. Install Jellyfin:
    sudo apt install jellyfin

  6. Manage the Jellyfin system service with your tool of choice:
    sudo service jellyfin status
    sudo systemctl restart jellyfin
    sudo /etc/init.d/jellyfin stop

Packages

Raw Debian packages, including old versions, are available here.

Note: The repository is the preferred way to obtain Jellyfin on Debian, as it contains several dependencies as well.

  1. Download the desired jellyfin and jellyfin-ffmpeg .deb packages from the repository.

  2. Install the downloaded .deb packages:
    sudo dpkg -i jellyfin_*.deb jellyfin-ffmpeg_*.deb

  3. Use apt to install any missing dependencies:
    sudo apt -f install

  4. Manage the Jellyfin system service with your tool of choice:
    sudo service jellyfin status
    sudo systemctl restart jellyfin
    sudo /etc/init.d/jellyfin stop

Ubuntu

Migrating to the new repository

Previous versions of Jellyfin included Ubuntu under the Debian repository. This has now been split out into its own repository to better handle the separate binary packages. If you encounter errors about the ubuntu release not being found and you previously configured an ubuntu jellyfin.list file, please follow these steps.

  1. Remove the old /etc/apt/sources.list.d/jellyfin.list file:
    sudo rm /etc/apt/sources.list.d/jellyfin.list

  2. Proceed with the following section as written.

Repository

The Jellyfin team provides an Ubuntu repository for installation on Ubuntu Xenial/Bionic/Cosmic/Disco. Supported architectures are amd64, arm64, and armhf. Only amd64 is supported on Ubuntu Xenial.

NOTE: Microsoft does not provide a .NET for 32-bit x86 Linux systems, and hence Jellyfin is not supported on the i386 architecture.

  1. Install HTTPS transport for APT if you haven't already:
    sudo apt install apt-transport-https

  2. Enable the Universe repository to obtain all the FFMpeg dependencies:
    sudo add-apt-repository universe

  3. Import the GPG signing key (signed by the Jellyfin Team):
    wget -O - https://repo.jellyfin.org/ubuntu/jellyfin_team.gpg.key | sudo apt-key add -

  4. Add a repository configuration at /etc/apt/sources.list.d/jellyfin.list:
    echo "deb [arch=$( dpkg --print-architecture )] https://repo.jellyfin.org/ubuntu $( lsb_release -c -s ) main" | sudo tee /etc/apt/sources.list.d/jellyfin.list

    NOTE: Supported releases are: xenial, bionic, cosmic, and disco.

  5. Update APT repositories:
    sudo apt update

  6. Install Jellyfin:
    sudo apt install jellyfin

  7. Manage the Jellyfin system service with your tool of choice:
    sudo service jellyfin status
    sudo systemctl restart jellyfin
    sudo /etc/init.d/jellyfin stop

Packages

Raw Ubuntu packages, including old versions, are available here.

Note: The repository is the preferred way to obtain Jellyfin on Ubuntu, as it contains several dependencies as well.

  1. Enable the Universe repository to obtain all the FFMpeg dependencies, and update repositories:
    sudo add-apt-repository universe
    sudo apt update

  2. Download the desired jellyfin and jellyfin-ffmpeg .deb packages from the repository.

  3. Install the required dependencies:
    sudo apt install at libsqlite3-0 libfontconfig1 libfreetype6 libssl1.0.0

  4. Install the downloaded .deb packages:
    sudo dpkg -i jellyfin_*.deb jellyfin-ffmpeg_*.deb

  5. Use apt to install any missing dependencies:
    sudo apt -f install

  6. Manage the Jellyfin system service with your tool of choice:
    sudo service jellyfin status
    sudo systemctl restart jellyfin
    sudo /etc/init.d/jellyfin stop

You can’t perform that action at this time.