Home Assistant
Edit this page on GitHub

DuckDNS

Duck DNS is a free service which will point a DNS (sub domains of duckdns.org) to an IP of your choice. This add-on includes support for Let’s Encrypt and will automatically create and renew your certificates.

{
  "lets_encrypt": {
    "accept_terms": true
  },
  "token": "sdfj-2131023-dslfjsd-12321",
  "domains": ["my-domain.duckdns.org"]
}

Configuration variables:

  • token (Required): Your Duck DNS API key.
  • domains (Required): A list of domains to update DNS.
  • seconds (Optional): Seconds between updates to Duck DNS.
  • lets_encrypt.accept_terms (Optional): If you accept the Let’s Encrypt Subscriber Agreement, it will generate & update Let’s Enrypt certificates for your DuckDNS domain.

Home Assistant configuration

Use the following configuration in Home Assistant to use the generated certificate:

http:
  base_url: https://my-domain.duckdns.org:8123
  ssl_certificate: /ssl/fullchain.pem
  ssl_key: /ssl/privkey.pem

If you use a other port as 8123 or a SSL proxy, change the port number.