Connect Unraid

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

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 the way Docker-direct exposes

If you also add Portainer or Docker-direct 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.

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.

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