Install Home Assistant (Supervised) on Debian

Welcome to the always up to date Home Assistant (Supervised) installation guide

This guide will go over how to install Home Assistant (Supervised) on Debian based Linux Distributions. Remember only the latest version of Debian is supported, no derivatives

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:

whoami

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 3: Install Dependency’s

Install all the required dependency’s with the following command:

apt install \
apparmor \
bluez \
cifs-utils \
curl \
dbus \
jq \
libglib2.0-bin \
lsb-release \
network-manager \
nfs-common \
systemd-journal-remote \
systemd-resolved \
udisks2 \
wget -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 get.docker.com | 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.
    (amd64)
 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:
 https://hub.docker.com/

For more examples and ideas, visit:
 https://docs.docker.com/get-started/

Step 2: Install Home Assistant

Installing Home Assistant is easy simply follow these steps

1. 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:

wget https://github.com/home-assistant/os-agent/releases/latest/download/os-agent_1.4.0_linux_x86_64.deb
apt install ./os-agent_1.4.0_linux_x86_64.deb

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

2. Run the Home Assistant Install Script

Now that you are root simply run these commands to download and install Home Assistant Supervised:

wget https://github.com/home-assistant/supervised-installer/releases/latest/download/homeassistant-supervised.deb
apt install ./homeassistant-supervised.deb

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

http://your.ip.address.here:8123

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

2. 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

\\your.ip.address.here\

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

Notes:

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 Bullseye you will get this notice in your supervisor (as shown in the image below):

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