# Connect Jellyfin

Add Jellyfin to Kochab with an API key and default port 8096.

Canonical: https://kochab.io/docs/services/jellyfin/

Jellyfin is a media server. Kochab uses its API for session and activity data, not for full server administration.

## What Kochab exposes through Jellyfin

- **Activity tab:** now playing streams, active sessions, and reachability, with pause/resume/stop per session
- **Detail surface:** live stream count and links to Activity and Library (Sonarr/Radarr catalog)
- **Push:** newly added media notifications. Kochab registers the webhook in Jellyfin for you when you add the service

## Not exposed through Jellyfin

User/library administration, plugin config, transcoding settings, and finer remote control (skip, volume, cast) stay in Jellyfin's apps and web UI. Kochab is not a Jellyfin remote control replacement.

## Before you start

In Jellyfin: **Dashboard -> Advanced -> API Keys**. Create a key and copy it.

## Default connection

| Field | Typical value |
|---|---|
| Port | **8096** |
| Scheme | `http` on LAN, `https` behind a reverse proxy |
| Auth | API key sent as `Authorization: MediaBrowser Token=...` |

## Add in Kochab

1. Open **Services -> Add service** and choose **Jellyfin**.
2. Enter your **host**.
3. Set port **8096** unless you use a custom port or proxy.
4. Paste the **API key**.
5. Tap **Test and add**.
6. Choose which libraries Kochab should include when prompted (you can change this later).

## TLS

See [Certificate trust](/docs/cert-trust) for self-signed certificates.

## Official docs

[Jellyfin API documentation](https://api.jellyfin.org/)