Common Issues

Apps won’t start

• Check Docker is running: docker info or cihub status
• Ensure enough disk space: df -h and docker system df
• Check the Log Viewer or cihub app logs <name>

Can’t access dashboard

• Verify Hub is running: cihub status or check Docker Desktop
• Try http://localhost:5002 (default API/dashboard port)
• On a remote server, use the server IP or Tailscale IP from Settings → Network

App Store is empty

• Check internet connectivity
• Restart Hub: cihub down && cihub up prod --detached
• Verify App Store URL in Settings if using a custom store

Portal pairing fails

• Generate a fresh pairing code in Portal (codes are single-use)
• Ensure Hub has outbound internet access
• See Device Pairing for reset steps

AI models not loading

• Install Ollama on the host: ollama.com 
• Set OLLAMA_HOST=0.0.0.0:11434 if containers can’t reach Ollama
• Run cihub models list to verify connectivity

Tailscale not connecting

• Complete authentication in the popup window
• Wait 5–10 seconds, then refresh Settings → Network
• See Tailscale troubleshooting