41 lines
1.2 KiB
Markdown
41 lines
1.2 KiB
Markdown
---
|
|
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.
|
|
|
|
<p class='note warning'>
|
|
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.
|
|
</p>
|
|
|
|
```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
|
|
```
|