Connect Portainer

Add Portainer to Kochab with an API access token and manage containers across environments.

Portainer aggregates Docker hosts as environments. Kochab proxies the Docker Engine API through Portainer; it does not read NAS storage or array state.

What Kochab exposes through Portainer

• Environments: pick local Docker, remote agents, or edge nodes registered in Portainer
• Containers: filter/search list, start/stop/restart/pause/unpause, log tail
• One Portainer entry can reach many hosts (via Portainer agents)

Not exposed through Portainer

• Unraid array/parity, TrueNAS pools, Synology volume layout, SMART, or VM/catalog-app surfaces
• Container detail screen with live CPU/memory stats (Docker-direct has this today)
• Image pull + recreate (planned separately from Unraid’s native Update)
• Unraid-style container icons (iconUrl); rows use Docker metadata only
• Sonarr/Radarr/etc. (always separate app connections)

Use Portainer for non-NAS Docker or extra hosts. On Unraid, TrueNAS, or Synology, prefer the native infra client for that box. See Infrastructure vs container integrations.

Before you start

In Portainer: My account -> Access tokens -> Add access token. Copy the token once (Kochab stores it in the device keychain).

Do not use your admin password in Kochab; the app expects an access token.

Default connection

Add in Kochab

1. Open Services -> Add service and choose Portainer.
2. Enter the URL of your Portainer server (for example https://192.168.1.10:9443).
3. Paste the access token.
4. Tap Test and add.
5. Open the service -> Manage containers and pick an environment (local Docker, agent, or edge node).

TLS

Self-signed Portainer certificates use the same trust flow as other services. See Certificate trust.

Tips

• One Portainer install can reach many hosts via agents; you still add one Portainer service in Kochab.
• Container detail, live stats, and logs are available per container after you select an environment.

Official docs

Portainer API documentation