Install on MacOS

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

note

Jellyfin requires macOS 10.15 or newer to run.

Install

1. Download the latest version.
2. Drag the .app package into the Applications folder.
3. Start the application.
4. Click the icon in the menu bar and select "Launch Web UI".

Upgrade

1. Download the latest version.
2. Stop the currently running server either via the dashboard or using the menu bar icon.
3. Drag the new .app package into the Applications folder and click yes to replace the files.
4. Start the application.

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 Configuration

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. Install the .NET Runtime and ASP.NET Core Runtime version 6.0. This can also be accomplished by installing the .NET SDK which includes both of these runtimes. Links to the official download page can be found here. Ensure you add the installation directory to your PATH variable.
2. Download the latest version of Jellyfin.
3. Extract it into the Applications folder.
4. Open Terminal and type cd followed with a space then drag the jellyfin folder into the terminal.
5. Type dotnet jellyfin.dll to run jellyfin.
6. 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, so to install FFmpeg you have three options.

• use the package manager homebrew by typing brew install ffmpeg into your Terminal (here's how to install homebrew if you don't have it already
• download the most recent static build from this link (compiled by a third party see this page for options and information), or
• compile from source available from the official website

More detailed download options, documentation, and signatures can be found.

If using static build, extract it to the /Applications/ folder.

Navigate to the Playback tab in the Dashboard and set the path to FFmpeg under FFmpeg Path.