Troubleshooting

Start here when something isn’t working. Most problems fall into one of four buckets.

First three commands

Whatever the symptom, these tell you where the problem is:


cihub status

Shows the Hub stack, ports, tunnel URL, Tailscale IP, and installed models. If this fails outright, the Hub stack isn’t running.


docker info

If this errors, Docker itself is the problem — go straight to Docker Issues.


cihub app logs <app-name>

If Hub is healthy but one app misbehaves, its logs are the fastest answer.

Symptom	Page
An app won’t start, dashboard unreachable, pairing fails	Common Issues
Docker won’t start, permission denied, disk full, port conflicts	Docker Issues
You need to read logs from the dashboard	Log Viewer
Nothing here fixed it	Getting Help

Before running any destructive reset (cihub uninstall, docker system prune -a), back up first — see Backup and restore.