This guide will go over how to install Home Assistant (Supervised) on Debian based Linux Distributions. I have modified this Guide to be Debian since Ubuntu Server is no longer officially supported

Important Please Read

Before continuing make sure you read and understand the following documents:

0014. Installation method: Home Assistant Supervised

0012. Define supported installation method

Pre-installation Steps

Step 1: Becoming Root

Before we start, you must make sure you are logged in as root, Debian may not come with sudo installed, so in order to become root type:

su -

Then enter the root password you configured during installation, Be sure not to forget the dash as it allows the system to run the login scripts for the root user.

However, if you are on a system with sudo installed you can use the command:

sudo su -

Before preceding, confirm you are root by typing:


You must be root in order to continue

Step 2: Updating your System

Before starting it is a good idea to update your system, to do so enter the three following commands:

apt-get update
apt-get upgrade -y
apt-get dist-upgrade -y

Step 1: Install The Docker Engine

1. Run the Docker CE installation script

Simply run the Docker CE for Linux installation script:

curl -fsSL | sh

2. Test your Docker Install (Optional)

To test your docker install run the hello-world script:

docker run hello-world

If Docker is working correctly the following message will be displayed:

Hello from Docker!
This message shows that your installation appears to be working correctly.

To generate this message, Docker took the following steps:
 1. The Docker client contacted the Docker daemon.
 2. The Docker daemon pulled the "hello-world" image from the Docker Hub.
 3. The Docker daemon created a new container from that image which runs the
    executable that produces the output you are currently reading.
 4. The Docker daemon streamed that output to the Docker client, which sent it
    to your terminal.

To try something more ambitious, you can run an Ubuntu container with:
 $ docker run -it ubuntu bash

Share images, automate workflows, and more with a free Docker ID:

For more examples and ideas, visit:

Step 2: Install Home Assistant

Installing Home Assistant is easy simply follow these steps

1. Install Dependency’s

apt-get install \
jq \
curl \
avahi-daemon \
udisks2 \
libglib2.0-bin \
network-manager \
dbus -y

3. Install the OS Agent

The OS Agent allows the Home Assistant Supervisor to communicate with D-Bus and will soon be required

To Install it simply use the follow commands:

dpkg -i os-agent_1.2.2_linux_x86_64.deb

Of course being sure you replace `os-agent_1.2.2_linux_x86_64.deb` with the latest version which matches your CPU architecture. Available at the GitHub Releases page

4. Run the Home Assistant Install Script

Now that you are root simply run this command to install Home Assistant:

curl -sL | bash -s

After it has finished running you should be able to access Home Assistant from:

Step 3: Post Install Steps

1. Install The SSH Add On

The SSH add on in Home Assistant allows you to access the Home Assistant command line interface which can be vary helpful for diagnosing issues with you Home Assistant install

  • To install SSH head to the Supervisor tab
  • Then click Add on Store
  • Now find Terminal & SSH and Click install

Before starting you must set a password and change the port as port 22 is already used by the Host’s SSH server

So before you start the Addon head to the configuration tab and change the Port setting under Network and add a password. Be sure to save both these settings then you can start the add on

You should now be able to now SSH into your hassio instance using the command

ssh [email protected] -p 29

3. Install SAMBA

SAMBA will allow you to access your configuration files from any PC on your local network

To install it simply

Find SAMBA share in the add on store

Edit the Configuration to to include your own username and password

Then save the config and start the add on

Now you should be able to access your files from any file manager on the network by typing


into your file browser

Your Home Assistant config files will be found in the config folder

Congratulations you have now setup Home Assistant!!!

Thanks for reading, if you have any questions feel free to contact me on Twitter or the DrZzs Discord Server


Ubuntu Server is no longer officially supported by Home Assistant

Home Assistant (Supervised) now only officially supports the latest version of Debian, That means that if anything breaks you cannot complain about it. However they are not preventing you from still installing it If you are installing Home Assistant Supervised on anything other than Debian Buster you will get this notice in your supervisor (as shown in the image below):

That being said I will still continue to use Ubuntu Server for my main install and I will update this blog post if I run into any issues or if anything major breaks, I will also be working on an installation guide for Home Assistant (Supervised) on Debian for those who are setting up a fresh install or want to switch over to an officially supported method. I would not panic… yet it looks like nothing has broken and it seems this has just been done so they don’t have to worry about testing on multiple distributions

To learn more please read the Home Architecture Decision Record Documents:

0014. Installation method: Home Assistant Supervised

0012. Define supported installation method

Also be sure to update me in the comments below or reach out to me on Twitter or Discord if you run into any issues you believe to be caused by this change

6 Replies to “Install Home Assistant (Supervised) on Debian”

  1. My Bad. This IS working. I just needed to change a few things to accommodate running Ubuntu Server 20.4 on a RPi 4 8GB. All good now. Thanks for your write-up! It helped quite a bit.

  2. I constantly had issues (data corruption, reboot failures etc.) with HassOS running in Oracle VirtualBox under Windows 10. I decided to try Debian and Portainer and it seems to be running stable so far. Thanks for the tips!

  3. If you are installing under Debian, Ubutnu or other system, you may(will) find that you lose audio when you install Home Assistant. For example, if you want to run Zoom on the same system…or play music outside Home Assistant. Everything looks right, you just can’t hear anything 🙂

    Home Assistant grabs the system audio as part of it’s startup….just in case you might want to use it. There is no option in Home Assistant to stop this….but the solution can be found at: .

Leave a Reply

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