home-assistant.github.io/source/_addons/lets_encrypt.markdown

layout	title	description	date	sidebar	comments	sharing	footer	featured
page	Let's Encrypt	Automatically manage your SSL certificate using Let's Encrypt.	2017-04-30 13:28	true	false	true	true	true

Setup and manage a Let's Encrypt 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.

{
  "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:

http:
  ssl_certificate: /ssl/fullchain.pem
  ssl_key: /ssl/privkey.pem