# Connect Sonarr

Add Sonarr to Kochab with your API key, default port 8989, and optional reverse-proxy base path.

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

Sonarr is a library manager. Kochab uses its API directly for library, search, calendar, and the download queue. It does not route through Unraid or Portainer.

## What Kochab exposes through Sonarr

- **Blended tabs:** Search (add titles), Library, Calendar/Wanted, and Sonarr items in Downloads
- **Push:** grab, import and health notifications. Kochab registers the webhook in Sonarr for you when you add the service.
- **Control screen:** version, health, disk space, quick commands (refresh downloads, RSS sync, search missing, force search), read-only quality profiles
- **Detail pages:** series/season/episode management via the shared Servarr UI

## Not exposed through Sonarr

Kochab is not a full Sonarr admin panel. Custom formats, indexer/download-client wiring, and deep media settings stay in Sonarr's web UI. Restarting the Sonarr **container** requires a separate host entry (Unraid, Portainer, etc.) if you want container control from Kochab.

## Before you start

In Sonarr: **Settings -> General -> Security -> API Key**. Copy the key shown there.

## Default connection

| Field | Typical value |
|---|---|
| Port | **8989** |
| Scheme | `http` on LAN, `https` behind a reverse proxy |
| Auth | API key in the `X-Api-Key` header |

## Add in Kochab

1. Open **Services -> Add service** and choose **Sonarr**.
2. Enter your **host** (same as the rest of your stack if Sonarr runs on the same box).
3. Set port **8989** unless you use a custom port or proxy.
4. Paste the **API key**.
5. If Sonarr sits behind a reverse proxy with a subpath (for example `/sonarr`), set **Base path** to match Sonarr's URL base.
6. Tap **Test and add**.

## TLS

If Sonarr uses a self-signed certificate, Kochab prompts you to trust the fingerprint before saving. See [Certificate trust](/docs/cert-trust).

## Tips

- The first service you add sets the host for the stack; later services on the same machine only need a port change.
- For access away from home, add an external address on the stack so Kochab switches automatically.

## Official docs

[Sonarr wiki](https://wiki.servarr.com/sonarr)