Install Home Assistant on Ubuntu Server 20.04 LTS


This guide will cover how to install Home Assistant on a clean Ubuntu Server install using Docker. The Home Assistant team refers to as a Supervised install.
One thing to note is that Home Assistant (Supervised) is only officially supported on Debian Buster. You will get a notice in the supervisor about it being an unsupported configuration. So far, I haven’t found
anything that doesn’t work and I much prefer to use Ubuntu instead of Debian because of familiarity.

Tools/Versions Used:


Download the latest version of Ubuntu Server. The version that I’m using is 20.04.01 LTS and can be downloaded here. I use Rufus to burn the ISO to a USB Flash drive but other applications will work.
Once you have the image created, boot it on a machine that will serve as your Home Assistant server. Complete the standard install and configure SSHD. Do not install any additional packages (we’ll do those later).
Once the install is complete, remove the flash drive and reboot into your new server configuration.

Update Ubuntu Packages

Log in to the server with the credentials that you configured during the install process. Before getting started, make sure that everything is up-to-date on the system and you have all the latest packages.

Install Docker

As of this writing, the Docker version that Ubuntu installs via its package manager is not the latest (which is a requirement for Home Assistant).
For this reason, we didn’t include it during the initial install and will instead, use the version directly from Docker.

  • Install dependency’s that Docker requires
  • Add the Docker GPG Key
  • Add the repository for Docker
  • Update the APT packages
  • Install Docker
  • Test the Docker Install

If everything is working correctly you should see the following:

Install Home Assistant

  • Install the dependencies that Home Assistant requires
  • Disable ModemManager
  • Change to root
  • Use the Home Assistant Install Script

You should now be able to connect to your new Home Assistant install using a browser and going to https://[YOURIPADDRES]:8123

Post-Install Docker (Optional)

  • Turn on Advanced Features by going to [YOUR PROFILE NAME] -> Advanced Mode
  • Install the SSH client so that you can edit your configuration files in the container
    1. Supervisor -> Add-on Store
    2. Search for “Terminal & SSH”
    3. Install the Add-on.
    • Note: If you wish to connect via the terminal, you will have to configure the SSH port to something other than port 22 since this is what the Ubuntu Server is using.

Leave a comment

Your email address will not be published. Required fields are marked *