Skip to content

Installation

Jump to bottom
iderex edited this page Jul 19, 2026 · 5 revisions

Installation

Install from the plugin catalog (recommended for testing)

  1. In Jellyfin, go to Dashboard → Plugins → Repositories and add the repository URL for the channel you want. One URL serves both Jellyfin generations — your server installs the matching build automatically. Add one of these:

    Channel Repository URL
    stable https://raw.githubusercontent.com/iderex/jellyfin-plugin-sso/manifest-release/manifest.json
    beta https://raw.githubusercontent.com/iderex/jellyfin-plugin-sso/manifest-beta/manifest.json
    • stable ships tagged releases only. beta publishes on every merge, so betas move fast and may break — use them for testing, not production.
    • Each manifest lists builds for both Jellyfin 10.11 (.NET 9) and Jellyfin 12.0 (.NET 10). Jellyfin filters by the plugin's target ABI, so your server is only ever offered the build that runs on it — you don't pick the generation, it does. Jellyfin 12.0 support is currently beta only (the stable 12.0 build lands at a 12.0 stable release).

  2. Go to Dashboard → Plugins → Catalog, find SSO Authentication, and install it.

  3. Restart Jellyfin to load the plugin.

The plugin GUID is unchanged from the original 9p4 plugin, so a new version installs over an existing one in place and keeps your existing configuration.

Build from source (alternative)

Requirements: the .NET 9 SDK (or the .NET 10 SDK for the Jellyfin 12.0 line). The plugin multi-targets net9.0/net10.0 for Jellyfin 10.11 and Jellyfin 12.0.

git clone https://github.com/iderex/jellyfin-plugin-sso
cd jellyfin-plugin-sso
dotnet publish -c Release

Copy the full publish output (SSO-Auth.dll and every dependency DLL beside it — the OpenID client, the embedded library, and the other referenced assemblies) into your Jellyfin plugins directory:

<jellyfin-config>/plugins/sso/

Restart Jellyfin. Copying only a subset of the DLLs can leave Jellyfin unable to load the plugin. JPRM packages the correct set for you if you prefer a single artifact.

Configure

Open Dashboard → Plugins → SSO-Auth and add your provider(s); see Provider Setup for per-identity-provider setup.

Repository · Issues · Releases · Security policy — report vulnerabilities privately, never in a public issue. Pages describe what is implemented today; if the wiki disagrees with the code, the code wins.

Home

Getting started

How it works

Security

Standards & process (internal / maintainer)

Clone this wiki locally