Apps

Jellyfin

Stream the movies, shows and music you own, from anywhere.

Version Jellyfin 12 Minimum 2 vCPU / 4096 MB RAM / 60 GB Opens in your browser Sign in as mapleadmin

What it is

Jellyfin turns a folder of video and music files into something that looks and works like a streaming service — posters, descriptions, resume where you left off, a separate profile for everyone in the house.

There are apps for phones, tablets, Android TV, Fire TV, Roku and web browsers. It is completely free, and nothing about what you watch leaves your server.

Good for

  • A family media library that works away from home
  • Ripped DVDs and Blu-rays, home videos, a music collection
  • Leaving a streaming subscription behind

Getting in

  1. Open the link on your console page and sign in as mapleadmin.
  2. Connect an SFTP client such as FileZilla or WinSCP using the SSH details on your console page.
  3. Upload into /opt/jellyfin/media/movies, /shows or /music.
  4. In Jellyfin, open the Dashboard and choose Scan All Libraries.
  5. Add a user for each person under Dashboard → Users, rather than sharing yours.

Your own address, port and any credentials are on your server's console page, reached from your dashboard. They are specific to your server, so they are not repeated here.

Things that catch people out

Your disk is your library

Video is large — a 1080p film is typically 2 to 8 GB. Check what your collection adds up to before you start uploading, and pick a plan with room for it.

Converting video on the fly is the expensive part

When a device can play a file as it is, streaming costs your server almost nothing. When it cannot, Jellyfin converts it live, and your server has room for about one of those at a time. 4K and HEVC files are the usual cause — lowering the quality setting in the app avoids it.

Name your files the way Jellyfin expects

Jellyfin finds posters and details by file name. "Movie Name (2019).mkv" and "Show Name/Season 01/Show Name S01E01.mkv" work; random names show up as unknown items.

The first upload is the slow one

Copying a collection takes as long as your home connection's upload speed allows. Leave it running overnight.

Sending Jellyfin through a VPN

If you have a NordVPN account, Jellyfin can fetch everything through it. Get an access token from your Nord account (Set up NordVPN manually → Generate new token), SSH in and run bash /opt/jellyfin/enable-vpn.sh. It uses a Canadian server unless you name another country, e.g. bash /opt/jellyfin/enable-vpn.sh "United States". Your address and how you watch do not change. If the VPN drops, Jellyfin goes offline rather than falling back to a direct connection — that is deliberate. To turn it off, run the same script with --rollback.

Where your data lives

Media files are plain folders under /opt/jellyfin/media. Settings, users and watch history live in Docker volumes under /opt/jellyfin.

Take a snapshot before anything risky — see Snapshots and backups.

Updating

Ubuntu patches itself, but the app does not. SSH in and run:

$ cd /opt/jellyfin && docker compose pull && docker compose up -d

Take a snapshot first.

Elsewhere

Other apps