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.
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.
Sign-in is part of the server, so there is no plugin to install.
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.
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 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.
Music apps use a generated token. Scripts use personal access tokens. Other clients use the same device sign-in as the TV.
Jellyfin apps cannot open your provider's login page, so they sign in a different way.
Use either, or both next to the built-in accounts.
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.
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.
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.
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
Lumastra mirrors your Audiobookshelf library and plays the books in its own player.
/j/, /subsonic/, /api/v1/ and /oauth/ check their own credentials. The guide lists the rules.AUTH_OIDC_BACKCHANNEL_LOGOUT_CASCADE=true to revoke device tokens too, or disable the user.More on access rules: Parental controls and age ratings · Connecting third-party apps