Are you ready to install Home Assistant Supervised on Debian-based Linux distribution? This guide will walk you through the process, step by step. But before we begin, there are a few essential things you need to know.
Important Please Read
Before you start the installation process, it’s crucial to read and understand the following documents:
0014. Installation method: Home Assistant Supervised
0012. Define supported installation method
Pre-installation Steps; Install Home Assistant Supervised on Debian
Step 1: Becoming Root
Before we begin, you need to ensure that you are logged in as root. If your Debian system does not come with sudo installed, you can become root by typing:
su -
Make sure to enter the root password you configured during installation. Don’t forget the dash, as it runs the login scripts for the root user. If sudo is installed on your system, you can use the following command instead:
sudo su -
To confirm that you are logged in as root, type:
whoami
Make sure the output is “root” before proceeding.
Step 2: Updating your System
Before we get started, it’s always a good idea to update your system. Use the following commands to update your system:
apt-get update apt-get upgrade -y apt-get dist-upgrade -y
Step 3: Install Dependencies
Next, we need to install some dependencies. Run the following command to install all the required dependencies:
apt-get install \ apparmor \ jq \ wget \ curl \ udisks2 \ libglib2.0-bin \ network-manager \ dbus \ lsb-release \ systemd-journal-remote \ systemd-resolved -y
Step 1: Install The Docker Engine
1. Run the Docker CE installation script
To install the Docker Community Edition (CE), simply run the following command:
curl -fsSL get.docker.com | sh
2. Test your Docker Install (Optional)
If you want to test your Docker installation, you can run the following command:
docker run hello-world
If Docker is installed correctly, you will see a message confirming that your installation is working correctly.
Step 2: Install Home Assistant
Now it’s time to install Home Assistant. Just 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, use the following 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
Make sure to replace “os-agent_1.4.0_linux_x86_64.deb” with the latest version that matches your CPU architecture. You can find the latest version on the GitHub Releases page.
2. Run the Home Assistant Install Script
Now that you are root, run the following 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
Once the installation is complete, you should be able to access Home Assistant using the following URL:
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 helpful for diagnosing issues with your Home Assistant installation.
To install the SSH add-on:
- Go to the Supervisor tab
- Click on Add-on Store
- Find Terminal & SSH and click on Install
Before you start the add-on, make sure to set a password and change the port. Port 22 is already used by the host’s SSH server. To do this, go to the Configuration tab and change the Port setting under Network. Add a password and save both settings. Then you can start the add-on.
You should now be able to SSH into your Home Assistant instance using the following command:
ssh root@your.ip.address.here -p 29
2. Install SAMBA
SAMBA allows you to access your Home Assistant configuration files from any PC on your local network.
To install SAMBA:
- Find the SAMBA Share add-on in the add-on store
- Edit the Configuration to include your own username and password
- 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 the following address into your file browser:
\\your.ip.address.here\
Your Home Assistant config files will be found in the config folder.
Read Also:Â Â A Simple Guide to Installing Home Assistant Operating System
Frequently Asked Questions (FAQ)
What is Home Assistant (Supervised)?
Home Assistant (Supervised) is an installation method that allows you to run Home Assistant on a generic Linux system. It provides more flexibility and control compared to other installation methods.
Do I need to be logged in as root to install Home Assistant (Supervised)?
Yes, you need to be logged in as root to install Home Assistant (Supervised). Make sure to follow the pre-installation steps in this guide.
Can I test my Docker installation?
Yes, you can test your Docker installation by running the “docker run hello-world” command. If Docker is installed correctly, you will see a message confirming that your installation is working correctly.
How can I access Home Assistant after installation?
Once Home Assistant is installed, you can access it by visiting http://your.ip.address.here:8123 in a web browser.
How can I access the Home Assistant command line?
To access the Home Assistant command line, you need to install the SSH add-on. Follow the steps outlined in this guide to install and set up the SSH add-on. Once installed, you can SSH into your Home Assistant instance using the command “ssh root@your.ip.address.here -p 29”.
How can I access my Home Assistant configuration files?
To access your Home Assistant configuration files from any PC on your local network, you need to install the SAMBA add-on. Follow the steps outlined in this guide to install and configure SAMBA. Once installed, you can access your files by typing “\\your.ip.address.here\” into your file browser.
That’s it! You have successfully installed Home Assistant (Supervised) on your Debian-based Linux distribution. Enjoy exploring and customizing your Home Assistant setup!
