# jellyfin-security-plugin

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.

- skill · `type=skill` · Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, OpenCode, Windsurf (Devin Desktop), Claude.ai · 265 installs · ★ 13 repo stars
- Author: reason-machines
- License: not stated · policy=link-only · description only; the file stays with the author
- Source: https://github.com/reason-machines/security-skills/tree/HEAD/skills/jellyfin-security-plugin/SKILL.md
- Updated: 2026-10-09
- Security check: automated, 2026-11-16 (text) — no signs of malicious code found.
- HTML: https://affpapa.org/en/nevibecode/skills/jellyfin-security-plugin

## What it 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`.

## Install

### Claude Code (native platform)

1. **Skills CLI (Vercel)**
```bash
npx skills add reason-machines/security-skills --skill jellyfin-security-plugin -a claude-code
```

2. **Manually: put the files in place**
- File: `~/.claude/skills/jellyfin-security-plugin/SKILL.md` — Copy the whole skill folder; for one project use .claude/skills/jellyfin-security-plugin/

### Codex

1. **Skills CLI (Vercel)**
```bash
npx skills add reason-machines/security-skills --skill jellyfin-security-plugin -a codex
```

2. **Manually: put the files in place**
- File: `.agents/skills/jellyfin-security-plugin/SKILL.md` — For all projects use ~/.agents/skills/

### Cursor

1. **Skills CLI (Vercel)**
```bash
npx skills add reason-machines/security-skills --skill jellyfin-security-plugin -a cursor
```

2. **Manually: put the files in place**
- File: `.cursor/skills/jellyfin-security-plugin/SKILL.md` — Cursor also reads .agents/skills/ and .claude/skills/

### GitHub Copilot

1. **GitHub CLI**
```bash
gh skill install reason-machines/security-skills skills/jellyfin-security-plugin
```

2. **Manually: put the files in place**
- File: `.github/skills/jellyfin-security-plugin/SKILL.md`

### Gemini CLI

1. **Skills CLI (Vercel)**
```bash
npx skills add reason-machines/security-skills --skill jellyfin-security-plugin -a gemini-cli
```

2. **Platform CLI**
```bash
gemini skills install https://github.com/reason-machines/security-skills --path skills/jellyfin-security-plugin
```

### Windsurf (Devin Desktop)

**Manually: put the files in place**
- File: `.devin/skills/jellyfin-security-plugin/SKILL.md` — The legacy .windsurf/skills/ path still works

### OpenCode

**Skills CLI (Vercel)**
```bash
npx skills add reason-machines/security-skills --skill jellyfin-security-plugin -a opencode
```

### Claude.ai

**Claude.ai**
- Zip the folder and upload it in Settings → Capabilities → Skills

Where a file is given instead of a command, copy the files from the source to that path: https://github.com/reason-machines/security-skills/tree/HEAD/skills/jellyfin-security-plugin/SKILL.md

## When to use it
- 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
- 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.

## Similar
- [axiom-security](https://affpapa.org/en/nevibecode/skills/axiom-security.md) — skill · 1300 installs
- [web-security-guard](https://affpapa.org/en/nevibecode/plugins/web-security-guard.md) — plugin · ★ 1013 repo stars
- [404-frameworks-quarkus-security](https://affpapa.org/en/nevibecode/skills/404-frameworks-quarkus-security.md) — skill · 294 installs
- [dotnet-api-security](https://affpapa.org/en/nevibecode/skills/dotnet-api-security.md) — skill · 169 installs
- [performing-api-rate-limiting-bypass](https://affpapa.org/en/nevibecode/skills/performing-api-rate-limiting-bypass.md) — skill · 259 installs
- [capgo-organization-management](https://affpapa.org/en/nevibecode/skills/capgo-organization-management.md) — skill · 744 installs

From the same set: [reason-machines/security-skills](https://affpapa.org/en/nevibecode/by/reason-machines/security-skills.md) — 129 cards

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md
