Docs
Connecting services, configuring notifications, and operating the app.
Getting started
Connect Kochab to the services that run your self-hosted media stack.
Search and scope prefixes
Narrow a Kochab search to movies, TV, music, sport and more by typing a scope before your term.
Add and configure a service
Connect Sonarr, Radarr, your download clients, and the rest of your stack to Kochab.
Certificate trust
How Kochab handles self-signed TLS certificates without sending keys to an unknown host.
Service setup guides
Per-service connection guides for Kochab - ports, API keys, and TLS.
Reverse proxies and remote access
How to reach your stack from outside the house - reverse proxies, base paths, tunnels, VPNs, and the login gates that quietly break API access.
Infrastructure vs container integrations
What Unraid, TrueNAS, Synology, and Portainer each expose in Kochab, and when to use which.
Why won't Kochab connect to my service?
A failed connection test at Add Service, worked through in order - protocol, port, base path, API key, network, certificate, login gate.
Works in a browser, but offline in Kochab
A browser carries sessions, redirects, and its own network - Kochab carries none of them. Check the gate, the address, and the network, in that order.
Why Kochab keeps asking to trust a certificate
When a repeated self-signed certificate prompt is a normal side effect of renewal, and when it is a sign to stop and check the server before tapping trust.
Downloaded, but Kochab's queue is empty
The queue and the library refresh on different schedules - an empty queue is correct the moment a download finishes, and the library catches up separately.
Kochab notifications aren't arriving
Push delivery has independent gates - OS permission, per-service setup, quiet hours, per-event muting - and Send Test Push narrows down which is closed.
Find services finds nothing on my network
The discovery scan probes from your phone, so the network it is on decides what it can find - work through network, VPN, and service checks in order.
My .kbk backup won't restore
Wrong passphrase, unsupported version, or an unreadable file - what each restore error means and what actually fixes it.
Set up Prowlarr indexer sync for Sonarr and Radarr
Connect Prowlarr to Sonarr and Radarr, choose a sync level, limit indexers by tag, and verify the result in Kochab.
Configure SABnzbd or NZBGet for Sonarr and Radarr
Set categories, paths, unpacking, and Sonarr or Radarr download-client entries without mixing TV and movie jobs.
Set up Seerr or Jellyseerr for family requests
Connect a media server and Sonarr or Radarr, choose safe default permissions, set request limits, and verify the household flow in Kochab.
Prowlarr vs Jackett
What Kochab exposes through each indexer manager, and which one to add first.
SABnzbd vs NZBGet
What Kochab exposes through each Usenet download client, and which one to add.
qBittorrent vs Transmission vs Deluge
What Kochab exposes through each torrent client, and which one to add.
What is an *arr stack?
The Servarr library managers, indexer managers, and download clients that make up a self-hosted media stack, and where Kochab fits.
Why is an indexer separate from a download client?
Searching for a release and fetching it are two different jobs, done by two different kinds of service.
Remote access with Tailscale
Reach your *arr stack from outside the house using Tailscale, with no reverse proxy or open ports, and how to point Kochab at it.
Remote access with Cloudflare Tunnel and Access
Expose your *arr stack through a Cloudflare Tunnel without forwarding a port, gate it with Cloudflare Access, and configure Kochab's service-token support.
Remote access with Caddy
Put your *arr stack behind Caddy with automatic HTTPS, subdomain or subpath routing, and how to configure Kochab for either shape.
Remote access with Traefik
Route your *arr stack through Traefik with Docker labels, subdomain or subpath routing, and how to configure Kochab for either shape.
Remote access with nginx or SWAG
Put your *arr stack behind an nginx reverse proxy (including LinuxServer's SWAG), subdomain or subpath routing, and how to configure Kochab for either shape.
Connect Sonarr
Add Sonarr to Kochab with your API key, default port 8989, and optional reverse-proxy base path.
Connect Radarr
Add Radarr to Kochab with your API key, default port 7878, and optional reverse-proxy base path.
Connect Lidarr
Add Lidarr to Kochab with your API key and default port 8686.
Connect Prowlarr
Add Prowlarr to Kochab with your API key and default port 9696.
Connect Bazarr
Add Bazarr to Kochab with your API key and default port 6767.
Connect Sportarr
Add Sportarr to Kochab with your API key and default port 7979.
Connect Jackett
Add Jackett to Kochab with your API key and default port 9117.
Connect NZBHydra2
Add NZBHydra2 to Kochab with your API key and default port 5076.
Connect SABnzbd
Add SABnzbd to Kochab with your API key and default port 8080.
Connect NZBGet
Add NZBGet to Kochab with username and password and default port 6789.
Connect qBittorrent
Add qBittorrent to Kochab with Web UI username and password and default port 8080.
Connect Transmission
Add Transmission to Kochab with username and password and default port 9091.
Connect Deluge
Add Deluge to Kochab with your Web UI password and default port 8112.
Connect Seerr
Connect Jellyseerr, Overseerr, or Seerr to Kochab for the Requests tab.
Connect Jellyfin
Add Jellyfin to Kochab with an API key and default port 8096.
Connect Plex
Add Plex to Kochab with Sign in with Plex and default port 32400.
Connect Emby
Add Emby to Kochab with an API key and default port 8096.
Connect Trakt
Connect a Trakt account to Kochab with device authorization.
Connect Tautulli
Add Tautulli to Kochab with its API key for Plex watch history, live activity, and playback stats.
Connect Jellystat
Add Jellystat to Kochab to read Jellyfin watch history and library play totals from your phone.
Connect Tracearr
Add Tracearr to Kochab with its public API key for cross-server streams, alerts, and playback analytics.
Connect Tdarr
Add Tdarr to Kochab for staging approvals, node controls, and transcode error reports.
Connect Unraid
Add Unraid to Kochab with an API key for infrastructure health, Docker containers, and storage.
Connect TrueNAS SCALE
Add TrueNAS to Kochab with a username and API key for apps, VMs, pools, and system health.
Connect Portainer
Add Portainer to Kochab with an API access token and manage containers across environments.
Connect Synology DSM
Add Synology to Kochab with DSM username and password and default port 5001.
Connect Wizarr
Add Wizarr to Kochab with its API key to see pending invitations, recently joined users, and whether each media server behind it is readable.