If you’ve made up your mind to expose your Home Assistant instance to the wild Internet, which is full of evil hackers, you should take care of the security. Today we’ll learn how to set up your HTTPS connection really quick and without pain. Well, almost no pain.
We’ll use Nginx Proxy Manager addon which will do all the dirty work for us. Why not use DuckDNS integration or Let’s Encrypt add-on instead? Well, those two also work well, but my goal was to find a scalable solution that will support as many addons with their own domains as necessary. I personally don’t like the idea of editing certificate file location for each addon configuration again and again.
What essentially Nginx Proxy Manager addon does is called “SSL termination”. It will receive encrypted incoming traffic from the internet, decrypt it and pass it to your local Home Assistant instance so that it will not even notice that HTTPS is used. You can still use local name inside your local network like
This method works pretty well with Google Home, Amazon Alexa, and other services where HTTPS endpoint is required.
- A static IP address that is accessible from outside. You can also use a dynamic IP address, but you should set up a Duckdns client which will send updates to Duckdns service once your IP is changed. Duckdns client set up is not covered within this article.
- duckdns.org account or your own domain
- Home Assistant OS or Home Assistant Supervised (we need one which supports add-ons)
There are plenty of resources describing how to set up port forwarding on a router, you can find one by googling
port forwarding <router name>. Once you figured it out, you’ll need to forward ports 443 (for HTTPS) and 80 (for Let’s Encrypt ACME protocol) to the local IP address of the machine running Home Assistant.
The current ip field will show your IP address, if it does not match your real IP, this is the place where you can change it.
Open your Home Assistant, go to Supervisor-> Add On Store. You want two addons: Nginx Proxy Manager and MariaDB.
A few words about MariaDB addon dependency. Former versions of Nginx Proxy Manager did not require MariaDB for operation, instead, they had it embedded as this is an essential part of Nginx Proxy Manager software. Later on, Frenk, who is the maintainer of the majority of Home Assistant OS addons, decided to split this dependency up so that HA users who already use MariaDB addon for the Home Assistant recorder component may not host extra instances of this database.
A minimum configuration setting for MariaDB addon is a password for
homeassistant user, which is not necessary for Nginx Proxy Manager but is essential if you decide to switch from SQLite database to something more productive. This is anyway is a good improvement which speed-ups Logbook and History pages in Home Assistant.
Once the password is set, MariaDB should start without errors. Now we need to install Nginx Proxy Manager. Once started, it will automatically find and connect to MariaDB addon without user intervention. No additional settings are required, we should open its page via Open Web UI link:
Log in using
email@example.com as username and password
changeme and immediately change password.
Go to Proxy Hosts, add your host, enable Websockets Support and hit Save:
At this point, it is recommended to open up Home Assistant URL http://dummytest.duckdns.org and ensure that basic HTTP access is working. it will be necessary to obtain a Let’s Encrypt certificate at the next step. If you don’t see your HA prompt, most probably port forwarding was not set up properly. You can also check your router’s firewall settings.
If Home Assistant is accessible (via HTTP), go back to the Nginx Proxy Manager addon page and edit the previously created connection. Go to SSL tab and select Request a new SSL Certificate, the switches Force SSL and I Agree to… should also be turned on. Save your settings:
That’s it! You can now open https://dummytest.duckdns.org in your browser and ensure that your connection is secure:
Addon will take care of automatic Let’s Encrypt certificate renewal. It is also highly recommended to set up two-factor authentication. As a second factor one may use one of TOTP smartphone applications like Google Authenticator or Authy.