jellyfin-security-plugin — Claude Code skill: Jellyfin 2FA and SSO
jellyfin-security-plugin walks your coding agent through adding two-factor login, passkeys, OIDC single sign-on and IP bans to a Jellyfin 10.11+ server.
no license 265 installs ★ 13 updated 2026-10-09
npx skills add reason-machines/security-skills --skill jellyfin-security-plugin -a claude-codeWhat jellyfin-security-plugin does
The skill covers JellyfinSecurity, a server-side plugin that puts authentication checks in front of Jellyfin. It handles TOTP codes from authenticator apps, WebAuthn passkeys, recovery codes, OIDC sign-in through Authentik, Authelia or Keycloak, IP lockouts after repeated failures and QR pairing for TV clients. Enforcement lives on the server, so every client inherits it, from the web UI to Roku and Kodi.
The skill itself is a SKILL.md file in the reason-machines/security-skills repo. Installing it into your assistant is separate from installing the plugin, which goes into Jellyfin through Dashboard → Plugins → Repositories with https://raw.githubusercontent.com/ZL154/JellyfinSecurity/main/manifest.json, then Catalog, install, restart. What the skill adds is the settings walk-through: attempt thresholds, lockout duration, LAN bypass CIDRs, step-up level.
Jellyfin 10.11 or newer is the floor. Watch TrustedProxyCIDRs: a broad range such as 10.0.0.0/8 makes the SEC-H3 guard reject LAN bypass for clients that show up without an X-Forwarded-For header, so pin your reverse proxy with a /32.
What it helps with
- add a second factor to Jellyfin logins
- wire Jellyfin to Authentik or Authelia over OIDC
- ban an IP after repeated failed sign-ins
- pair a TV client by QR code
- review who signed in and what settings changed
Example prompts for the agent
- Install JellyfinSecurity on my Jellyfin server and turn on TOTP with recovery codes.
- Set up OIDC login through Authentik for Jellyfin and read the client secret from an env var.
- Fix the LAN bypass so clients on
192.168.0.0/16skip the second factor.
How to install jellyfin-security-plugin
1Skills CLI (Vercel)
npx skills add reason-machines/security-skills --skill jellyfin-security-plugin -a claude-code2Manually: put the files in place
~/.claude/skills/jellyfin-security-plugin/SKILL.mdCopy the whole skill folder; for one project use .claude/skills/jellyfin-security-plugin/
1Skills CLI (Vercel)
npx skills add reason-machines/security-skills --skill jellyfin-security-plugin -a codex2Manually: put the files in place
.agents/skills/jellyfin-security-plugin/SKILL.mdFor all projects use ~/.agents/skills/
1Skills CLI (Vercel)
npx skills add reason-machines/security-skills --skill jellyfin-security-plugin -a cursor2Manually: put the files in place
.cursor/skills/jellyfin-security-plugin/SKILL.mdCursor also reads .agents/skills/ and .claude/skills/
1GitHub CLI
gh skill install reason-machines/security-skills skills/jellyfin-security-plugin2Manually: put the files in place
.github/skills/jellyfin-security-plugin/SKILL.md1Skills CLI (Vercel)
npx skills add reason-machines/security-skills --skill jellyfin-security-plugin -a gemini-cli2Platform CLI
gemini skills install https://github.com/reason-machines/security-skills --path skills/jellyfin-security-pluginManually: put the files in place
.devin/skills/jellyfin-security-plugin/SKILL.mdThe legacy .windsurf/skills/ path still works
Skills CLI (Vercel)
npx skills add reason-machines/security-skills --skill jellyfin-security-plugin -a opencodeClaude.ai
Zip the folder and upload it in Settings → Capabilities → Skills
Step by step, with commands for each platform: How to install skills in Claude Code: five ways
Questions about jellyfin-security-plugin
How do I install jellyfin-security-plugin in Claude Code?
Run npx skills add reason-machines/security-skills --skill jellyfin-security-plugin -a claude-code. The skill lands at ~/.claude/skills/jellyfin-security-plugin/SKILL.md.
What does jellyfin-security-plugin do?
It guides an agent through installing and configuring the JellyfinSecurity plugin on Jellyfin 10.11+: second factor, passkeys, OIDC sign-in, IP bans, TV pairing and an audit log.
What do I need for the OIDC setup?
Client credentials from your identity provider: ClientID, ClientSecret and Authority. The sample settings read the secret from the OIDC_CLIENT_SECRET environment variable.