# Connect Lidarr

Add Lidarr to Kochab with your API key and default port 8686.

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

Lidarr is a music library manager. Kochab uses its API directly for library, search, calendar, and the download queue.

## What Kochab exposes through Lidarr

- **Blended tabs:** Search, Library, Calendar/Wanted, and Lidarr grabs in Downloads
- **Push:** grab, import, import-failure and health notifications. Kochab registers the webhook in Lidarr for you when you add the service.
- **Control screen:** health, disk, commands, read-only profiles
- **Detail pages:** artist/album management via the shared Servarr UI

## Not exposed through Lidarr

Full Lidarr admin stays in Lidarr's web UI. Container control requires a separate host entry if needed.

## Before you start

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

## Default connection

| Field | Typical value |
|---|---|
| Port | **8686** |
| 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 **Lidarr**.
2. Enter your **host**.
3. Set port **8686** unless you use a custom port or proxy.
4. Paste the **API key**.
5. If Lidarr sits behind a reverse proxy with a subpath, set **Base path** to match Lidarr's URL base.
6. Tap **Test and add**.

## TLS

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

## Official docs

[Lidarr wiki](https://wiki.servarr.com/lidarr)