# Connect Unraid

Add Unraid to Kochab with an API key for infrastructure health, Docker containers, and storage.

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

Unraid is an **infrastructure** service in Kochab (not a blended library surface). Kochab uses Unraid's GraphQL API, not Portainer and not the raw Docker Engine API.

## What Kochab exposes through Unraid

- **Infrastructure:** array and cache disks, parity status, capacity, CPU/RAM, network, and temperature sensors
- **Docker (Unraid-native):** container list with Unraid icons, start/stop/restart, pause/unpause, log tail, autostart toggle, and **Update** (pull + recreate) when Unraid reports a newer image
- **Home glance:** infra summary card and alerts (degraded array, parity check, critical temps, container down)

## Not exposed through Unraid

- VM management, TrueNAS-style catalog apps, or multi-host Docker environments
- Sonarr/Radarr/Plex library data (add those apps separately on their own ports)
- Raw Docker Engine inspect/stats JSON (Unraid surfaces its own Docker UI, not the raw Engine)

If you also add Portainer against the same Unraid Docker socket, you will see duplicate container lists with fewer NAS features. Prefer this native entry on Unraid.

See [Infrastructure vs container integrations](/docs/infra-vs-containers/).

## Before you start

In Unraid: **Settings -> Management Access -> API Keys**. Create a key with access to the GraphQL API.

## Default connection

| Field | Typical value |
|---|---|
| Port | **443** (HTTPS web UI) |
| Scheme | `https` |
| Auth | API key in the `X-Api-Key` header |

## Add in Kochab

1. Open **Services -> Add service** and choose **Unraid**.
2. Enter your **tower hostname or IP** (for example `tower.local`).
3. Port **443** unless you use a custom TLS port.
4. Paste the **API key**.
5. Tap **Test and add**.
6. Open **Infrastructure** from the service row or Home card for pools, stats, and containers.

## TLS

Unraid commonly uses a self-signed certificate. Trust the fingerprint when Kochab prompts you. See [Certificate trust](/docs/cert-trust).

## Tips

- Container **Update** (pull latest image) is available on Unraid's native surface when an update is available.
- Roaming: add an external URL on the stack if you reach Unraid over VPN or a public hostname away from home.

## Official docs

[Unraid API documentation](https://docs.unraid.net/API/)