Lumastra and Jellyfin

A self-hosted Jellyfin alternative

Lumastra is an open-source, self-hosted alternative to Jellyfin for movies, series, music and Live TV, with audiobooks through Audiobookshelf. It runs with Docker Compose or on Kubernetes, signs users in through your identity provider, and works with Jellyfin apps.

AGPL-3.0, including the Jellyfin-compatible API. No paid parts, no licence keys.

Using your existing Jellyfin apps

Lumastra speaks the Jellyfin API at /j. It needs no Jellyfin server behind it.

Server address: https://media.example.com/j, with your Lumastra username. Lumastra for Jellyfin apps

Keeping watch progress in sync

Lumastra can run next to Jellyfin and exchange watch state in both directions.

Try both safely

  1. Install Lumastra and mount the media folders Jellyfin uses. The Compose file mounts them read-only.
  2. In the setup wizard, enter your Jellyfin address and an API key from Jellyfin's dashboard.
  3. Create Lumastra accounts with the same usernames as in Jellyfin.
  4. Watch on either server and compare. Progress follows you within minutes.
  5. When you have decided, set FEATURE_JELLYFIN_SYNC=false. Each server keeps the watch state it has.

Jellyfin watch-state sync

Lumastra and Jellyfin side by side

Jellyfin is lighter, more mature and has many more apps, so it fits small systems such as a Raspberry Pi better. Lumastra is built as separate services with PostgreSQL.

CapabilityLumastraJellyfin
LicenceAGPL-3.0GPL-2.0
PriceFree, no paid partsFree server and official clients
DatabasePostgreSQL 17 or newer, requiredSQLite, built in
ContainersDocker ComposeDocker, Docker Compose, Podman
KubernetesHelm chart: web replicas, router, separate workerHelm chart
OIDC single sign-onNative in every Lumastra client: web, iPhone, iPad, Apple TV (QR sign-in) and API apps. Jellyfin apps pair with Quick Connect or a generated client passwordVia community plugin
LDAP loginNot supported; use your OIDC providerVia official plugin
Quick ConnectSupported for Jellyfin appsBuilt in
Live TVBuilt inBuilt in
Live TV recordingNot supportedBuilt in
Watching togetherWatch Together, in the web app and the Apple TV appSyncPlay, built in
AppsWeb, Apple TV, iPhone, iPad; Jellyfin and Subsonic appsMany official and third-party apps

Jellyfin column: jellyfin.org documentation and the Jellyfin GitHub repositories, checked on 14 November 2026.

Running Lumastra on Kubernetes

The Helm chart deploys each job as its own workload.

Web replicas and a router

Two web pods by default. An nginx router keeps every request of one playback session on the same pod.

A separate worker

Scans, artwork and analysis run in their own pod with their own limits.

PostgreSQL

Use CloudNativePG or your own PostgreSQL.

Valkey

The chart bundles one Valkey for the task queue and one for the cache.

Lumastra on Kubernetes

Accounts and single sign-on

Single sign-on is part of the server and native in every Lumastra app. There is no plugin to install, and the apps sign in through your provider instead of a separate password.

Lumastra with single sign-on

Playback and client compatibility

Connecting third-party apps

Deployment requirements

Docker Compose guide · Kubernetes guide