Settings

CitrineOS server configuration and connection endpoints

CitrineOS runs 3 WebSocket servers supporting OCPP 1.6, 2.0.1 and 2.1 simultaneously. Choose the right endpoint for your charger.

Testing / Development
Security Profile 0 · Port 8081
ws://161.97.165.207:8081/[charger-id]

No auth, no TLS. Any charger can connect. Use for local testing only.

OCPP 1.6OCPP 2.0.1OCPP 2.1
Production (plain WS + basic auth)
Security Profile 1 · Port 8082
ws://161.97.165.207:8082/[charger-id]

Requires HTTP Basic Auth credentials. No TLS encryption.

OCPP 1.6OCPP 2.0.1OCPP 2.1
Production (secure WSS)
Security Profile 1 · Port 443
wss://ocpp.cirhex.com/[charger-id]

TLS via Let's Encrypt. Nginx terminates SSL, proxies to port 8082. Recommended for production.

OCPP 1.6OCPP 2.0.1OCPP 2.1
Mutual TLS (mTLS)
Security Profile 2 · Port 8443
wss://161.97.165.207:8443/[charger-id]

Security Profile 2. Requires client certificate. CitrineOS uses self-signed certs.

OCPP 1.6OCPP 2.0.1OCPP 2.1
How to connect a charger
  1. Choose the appropriate endpoint above based on your security requirements
  2. Replace [charger-id] with your charger's unique ID (e.g. cp001)
  3. Configure this URL in your charger's OCPP settings
  4. The charger will appear in the Chargers tab once connected