Quickstart

This quickstart takes you from a new Dashboard org to a live OCPP session. You need network access from a charge point (or simulator) to the GridOS OCPP endpoint.

Goals

By the end you will have:

1. An organization in Dashboard
2. A registered charge point pointed at GridOS
3. A successful BootNotification and an online station
4. At least one completed test session

Prerequisites

• Dashboard access for your tenant
• Either a real charger or the simulator guide
• Outbound WebSocket (TLS preferred) from the station to GridOS

Never paste live OCPP passwords, OCPI tokens, or client certificates into tickets, chat, or public issues. Rotate anything that may have been exposed and use Dashboard or your secret store for operational credentials.

Steps

1. 1

   Create or join an organization

   Sign in to the Dashboard and complete org onboarding. Chargers, sessions, roaming partners, and webhooks are all tenant-scoped.

2. 2

   Register a charge point

   In Dashboard, open Add charger and fill every field (identity, OCPP version, brand, model, connectors). Full field guide: Create a charger.

   Value	Where you use it
   Charge point identity	OCPP chargePointId / station id on the device
   OCPP endpoint URL	CSMS URL on the charger or simulator
   Security profile	TLS, basic auth, or certificate profile as configured for the org

3. 3

   Point the charger at GridOS

   Configure the station CSMS URL to the GridOS OCPP gateway for your environment. Prefer TLS and the highest security profile your hardware supports. See Connect a charger for a full checklist.

   1# Shape only — use the values shown in the Dashboard for your org
   2wss://ocpp.example.com/<org-or-env>/<charge-point-id>

4. 4

   Confirm BootNotification

   When the station connects, Dashboard should show it online. If it stays offline:

   1. Confirm WebSocket reachability and TLS trust
   2. Match the charge point id exactly to Dashboard
   3. Check observability / message logs for BootNotification rejects
5. 5

   Run a test session

   Start a session from the station or via remote start (when authorized). Confirm:

   • Session appears under charge sessions
   • Meter values update (if enabled on the station)
   • Stop is clean and energy totals look sane

Example configs

Sample station and auth shapes (illustrative — use values from the Dashboard):

1{
2  "chargePointId": "CP001",
3  "ocppVersion": "1.6",
4  "csmsUrl": "wss://ocpp.example.com/env/CP001"
5}

Protocol depth (optional next)

Next steps

• Concepts — CPO, eMSP, OCPP vs OCPI
• Connect a charger — production connection checklist
• OCPI credentials — roaming handshake