Connect Sonarr
Add Sonarr to Kochab with your API key, default port 8989, and optional reverse-proxy base path.
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
- Control screen: version, health, disk space, quick commands (refresh downloads, RSS sync, search missing), read-only quality profiles and root folders
- 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, notifications, 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
- Open Services -> Add service and choose Sonarr.
- Enter your host (same as the rest of your stack if Sonarr runs on the same box).
- Set port 8989 unless you use a custom port or proxy.
- Paste the API key.
- If Sonarr sits behind a reverse proxy with a subpath (for example
/sonarr), set Base path to match Sonarr’s URL base. - Tap Test and add.
TLS
If Sonarr uses a self-signed certificate, Kochab prompts you to trust the fingerprint before saving. See Certificate 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.