Skip to main content
skill CX Codex

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

Install into Claude Code · Skills CLI (Vercel) All methods and platforms ↓
npx skills add reason-machines/security-skills --skill jellyfin-security-plugin -a claude-code
Open on GitHub

What 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/16 skip 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-code

2Manually: put the files in place

~/.claude/skills/jellyfin-security-plugin/SKILL.md

Copy the whole skill folder; for one project use .claude/skills/jellyfin-security-plugin/

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.

Similar skills

All skills for Security →

From the same set129

The whole set →
linux-pentesting-command-reference linux-pentesting-command-reference — a skill that feeds the agent a Linux command cheat sheet for recon, service enumeration, privilege escalation and staying on the box. Handy in labs and CTFs where a one-liner beats theory. CX Codex +1 290installs microsoft-security-skills-plugin This skill gives AI agents Microsoft Security guidance for Defender, Sentinel, Entra, Purview, and Intune. Use it when planning policies or security workflows. CX Codex +1 276installs pentest-r1-autonomous-penetration-testing pentest-r1-autonomous-penetration-testing guides setup of a two-stage reinforcement learning pipeline for autonomous penetration testing. Ideal for training security models in interactive sandboxes. CX Codex +1 271installs solana-security-standard solana-security-standard is a Claude Code skill that detects 37 vulnerability classes in Solana and Anchor programs during development and CI. CX Codex +1 268installs deepseek-pentest-ai-burp-extension deepseek-pentest-ai-burp-extension guides configuration and usage of a DeepSeek-driven Burp Suite extension to automate parameter detection and security fuzzing. CX Codex +1 262installs claude-pentest-framework claude-pentest-framework — a Claude skill that runs a structured pentest with 15 executor agents and 63 attack categories, asking the operator for approval before anything is exploited. CX Codex +1 261installs pentester-mcp-security-tools pentester-mcp-security-tools connects over 200 penetration testing tools to AI coding agents via MCP. Useful for automated port scanning and directory fuzzing from chat. CX Codex +1 261installs drm-pentesting-toolkit The drm-pentesting-toolkit skill guides agents through a plugin-based DRM testing toolkit for device files, MPD manifests, and license-server requests. Use it for authorized testing. CX Codex +1 261installs

Project sponsors

Companies that keep this analytics open