diff --git a/docs/installation.md b/docs/installation.md index d4a18df6..12f1bb45 100644 --- a/docs/installation.md +++ b/docs/installation.md @@ -27,9 +27,15 @@ Installation ### Secure Connection -If using [Let’s Encrypt](https://github.com/home-assistant/addons/tree/master/letsencrypt), [Duck DNS](https://www.home-assistant.io/integrations/duckdns/) or other add-ons that enables HTTPS you can get a secure WWS connection for OCPP. For more information on how to generate keys [see this blog post](https://www.home-assistant.io/blog/2017/09/27/effortless-encryption-with-lets-encrypt-and-duckdns/). -- The option secure connection enables connection thru WSS (HTTPS). With the option disabled the connection will be WS (HTTP). -- If enabled provide pathways to SSL certificate and key files. The pathways will be ignored if secure connection is disabled. +If you are using [Let’s Encrypt](https://github.com/home-assistant/addons/tree/master/letsencrypt), [Duck DNS](https://www.home-assistant.io/integrations/duckdns/) or other add-on that enables secure HTTPS for your Home Assistant instance, you can get a secure WSS connection for OCPP. +To use a secure connection: +- Enable the option _Secure connection_ +- Provide the pathways to your HA's SSL certificate and key files. These are typically located in the /config or /ssl folder, and typically named fullchain.pem and privkey.pem respectively. +- If you provide incorrect pathways, the integration will fail to setup with no clear indication of why. + +If you do not use HTTPS for your Home Assistant instance: +- Disable the option _Secure connection_ +- _Path to SSL certificate/key_ will be ignored. @@ -55,6 +61,7 @@ If using [Let’s Encrypt](https://github.com/home-assistant/addons/tree/master/ - Configure your charger to use the OCPP websocket of your Central System (e.g. ws://homeassistant.local:9000). This is charger specific, so consult your manual. - Some chargers require the protocol section 'ws://' to be removed, or require the url to end with a '/'. +- If you have configured _Secure connection_ in previous step, you should use 'wss://' - Some chargers require the url to be specified as an IP address, i.e. '192.168.178.1:9000' - You may need to reboot your charger before the changes become effective.