--- layout: page title: "Let's Encrypt" description: "Automatically manage your SSL certificate using Let's Encrypt." date: 2017-04-30 13:28 sidebar: true comments: false sharing: true footer: true featured: true --- Setup and manage a [Let's Encrypt](https://letsencrypt.org/) certificate. This will create a certificate on the first run and will auto-renew if the certificate is within 30 days of expiration.
This add-on need port 80/443 to verify the certificate request, please stop all add-ons that also use these ports, or you may not be able to start this add-on.
```json { "challenge": "https", "email": "example@example.com", "domains": ["example.com", "mqtt.example.com", "hass.example.com"] } ``` Configuration variables: - **challenge** (*Optional*): Default it use 443 ('https') you can change it to 'http' for use port 80. - **email** (*Required*): Your email address for registration on Let's Encrypt. - **domains** (*Required*): A list of domains to create/renew the certificate. ## {% linkable_title Home Assistant configuration %} Use the following configuration in Home Assistant to use the generated certificate: ```yaml http: ssl_certificate: /ssl/fullchain.pem ssl_key: /ssl/privkey.pem ```