Connectivity Issues
Cannot Access the Web UI
| Symptom | Cause | Solution |
|---|---|---|
| Browser shows “Connection refused” | Edge service not running | Check: docker compose ps — restart if needed |
| Browser shows “502 Bad Gateway” | Reverse proxy misconfigured | Verify Traefik/nginx config and upstream port |
| Browser shows SSL error | Certificate expired or invalid | Renew certificate or check Let’s Encrypt config |
| Page loads but shows blank | JavaScript error | Open browser DevTools console and check for errors |
Device Cannot Connect
Inspire uses a single HTTPS port (443) for all traffic. Ensure outbound HTTPS from the device to the server is allowed.
| Symptom | Cause | Solution |
|---|---|---|
| Pairing page does not load | DNS or network issue | Verify the device can reach the server: try loading the URL in a browser |
| Pairing page loads but code is not accepted | Code expired | Refresh the pairing page to get a new code |
| Device pairs but shows “Connecting…” | WebSocket blocked | Configure proxy/firewall to allow WebSocket upgrade on port 443 |
| Device connects then disconnects repeatedly | Unstable network | Check Wi-Fi signal or switch to Ethernet |
WebSocket / SignalR Issues
Inspire uses SignalR over WebSocket for real-time data push. Common blockers:
| Blocker | Solution |
|---|---|
Corporate proxy strips Upgrade header | Configure proxy to pass WebSocket upgrade headers |
| Firewall blocks long-lived connections | Allow persistent HTTPS connections to the Inspire server |
| Load balancer without sticky sessions | Enable sticky sessions or WebSocket-aware routing |
| Anti-virus/security software intercepting | Add the Inspire server to the allow list |
Testing WebSocket connectivity
Open a browser on the device and navigate to:
https://inspire.yourcompany.com/api/health/wsIf WebSocket is working, you will see a “Connected” message. If not, check the browser console for error details.
DNS Issues
| Symptom | Solution |
|---|---|
| Device cannot resolve hostname | Verify DNS settings on the device |
| Works with IP but not hostname | Check DNS A record for the Inspire domain |
| Intermittent DNS failures | Consider using a local DNS server or static hosts file entry |
Firewall Configuration
Minimum required access from display devices:
| Direction | Protocol | Port | Destination |
|---|---|---|---|
| Outbound | HTTPS | 443 | Inspire server |
| Outbound | DNS | 53 | DNS server |
Last updated on