Home Bridge Connectors & Networking Troubleshooting: Why is my Bridge showing 'Offline'?

Troubleshooting: Why is my Bridge showing 'Offline'?

Last updated on Mar 31, 2026

Connectivity Issues

If your SoLoPrint dashboard shows an Offline indicator next to your Bridge, our cloud has lost the WebSocket heartbeat.

1. Is the Pi Powered On?

The most common issue is that the Raspberry Pi or host computer was powered off, lost Wi-Fi, or crashed. Ensure the green networking LEDs are blinking on the Pi.

2. Is the Service Running?

SSH into your Pi (ssh pi@octopi.local) and check the daemon status:

sudo systemctl status soloprint-bridge

If it says failed or exited, there may be a configuration error.

3. Was the Key Rotated?

If you recently generated a new token in the dashboard, the Bridge is attempting to authenticate with a revoked token. Update /etc/soloprint/bridge.env with the new key.

4. DNS Issues

In rare cases, your Pi's DNS setting acts up, meaning it cannot resolve soloprint.app. Try ping google.com from your SSH terminal to ensure outbound internet functions correctly.