Troubleshooting
Failure-mode landings for charger connections, OCPP sessions, and OCPI credentials handshakes on GridOS.
Use this section when something fails in production or on a simulator — not for first-time setup. Prefer the linked guides below, then dive into protocol message pages if you need payload detail.
Start here
| Symptom | Go to |
|---|---|
| Charge point never appears online / no BootNotification | Charger will not connect |
| WebSocket connects then drops; auth or TLS errors | Charger will not connect |
| OCPI versions/credentials exchange fails | OCPI handshake failures |
| Tokens, locations, or CDRs rejected after handshake | OCPI handshake failures |
Setup guides (healthy path)
Protocol indexes
When the failure is message-specific, open the versioned action or module index and search (⌘K):
Dashboard
Use the Dashboard station detail, connection logs, and roaming partner surfaces to confirm identity, endpoint URL, and last error text before changing device configuration.