Common Issues

Apps Won’t Start

• Check that Docker is running: sudo systemctl status docker
• Ensure you have enough disk space: df -h
• Check the Log Viewer for error messages

Can’t Access Dashboard

• Verify the server IP address
• Check that Companion Home is running: docker compose ps
• Try accessing via http://<ip>:80 or the custom port you configured

App Store is Empty

• Check your internet connection
• The app store repository may need to be re-pulled. Try restarting Companion Home

Portal Pairing Fails

• Ensure your Hub has outbound internet access
• Check that the pairing code hasn’t expired
• Try generating a new pairing code