Lumastra with single sign-on

Media server SSO with Authentik, Authelia and Keycloak

Lumastra is a self-hosted media server where single sign-on is native, not an add-on. OIDC and forward authentication are part of the server, and every Lumastra app signs in through Authentik, Authelia, Keycloak or any other OIDC provider: the browser, iPhone and iPad, and the TV, where people scan a QR code and approve it on your own login page. Jellyfin apps pair with Quick Connect from a signed-in browser.

Single sign-on is part of the AGPL-3.0 server, free to use.

One provider for every screen

Sign-in is part of the server, so there is no plugin to install.

Web app

The login page shows a "Sign in with" button for your provider. Behind a forward-auth proxy, users are signed in as soon as they arrive.

Apple TV, iPhone and iPad

The app shows a QR code and a short code. The user opens the link on a phone, signs in at your provider and approves. No password is typed on the TV.

Jellyfin apps

Jellyfin apps ask for a user name and password, so each user generates a client password in Settings. Apps with Quick Connect pair by code from a signed-in browser.

Subsonic apps and API clients

Music apps use a generated token. Scripts use personal access tokens. Other clients use the same device sign-in as the TV.

Lumastra on Apple TV showing Scan to connect, a QR code and an alternative device code
Sign-in on Apple TV. The code is approved in a browser that is signed in through your provider.

Using Jellyfin apps with Authentik

Jellyfin apps cannot open your provider's login page, so they sign in a different way.

Streamyfin and Jellyfin apps

OIDC or forward auth

Use either, or both next to the built-in accounts.

OpenID Connect

Set the issuer URL, client ID and client secret. Users are created at their first sign-in. Back-channel logout is supported: signing out at the provider ends the Lumastra session.

Forward auth

Your proxy signs the user in and sends the name and groups as headers. Lumastra accepts them only from the proxy addresses you list. Header names are configurable for Authentik, Authelia or oauth2-proxy.

Groups decide access

Members of your admin group become admins. A user in the group age-12 sees only titles rated 12 and under. The group claim and the prefix are configurable.

Offboarding in one step

Disable a user in the admin area. That ends their browser sessions, device tokens, personal tokens and their Jellyfin and Subsonic sessions.

The guide has numbered steps for Authentik, the settings for Keycloak, and an nginx example for forward auth. On Kubernetes the same settings are Helm values. Authentication guide

Audiobookshelf behind the same login

Lumastra mirrors your Audiobookshelf library and plays the books in its own player.

Audiobooks guide

Good to know

More on access rules: Parental controls and age ratings · Connecting third-party apps