Section 1: Preparing Your System
Step 1: Update Debian and Install Docker
- Open your terminal (or connect via SSH using Putty). Start with root privileges:
sudo -i
- Update your system and remove unnecessary packages:
apt update && sudo apt upgrade -y && sudo apt autoremove -y
- Fix broken installations:
apt --fix-broken install
- Install necessary dependencies:
apt install apparmor jq wget curl udisks2 libglib2.0-bin network-manager dbus lsb-release systemd-journal-remote systemd-resolved -y
- Install Docker using the following command:
curl -fsSL get.docker.com | sh
Step 2: Updating OS Agent
- Go to the Home Assistant OS Agent GitHub page and note the latest version number.
- Replace
1.6.0
in the command below with the latest version you found:
wget https://github.com/home-assistant/os-agent/releases/download/1.6.0/os-agent_1.6.0_linux_x86_64.deb dpkg -i os-agent_1.6.0_linux_x86_64.deb
for debian 12 arm64
wget
https://github.com/home-assistant/os-agent/releases/download/1.6.0/os-agent_1.6.0_linux_aarch64.deb dpkg -i
os-agent_1.6.0_linux_aarch64.deb
Section 2: Installing Home Assistant Supervised
Step 1: Setting Up the Installation
- Ensure you are working as root (especially if you have rebooted after Section 1):
sudo -i
- Download and install the Home Assistant Supervised package:
wget https://github.com/home-assistant/supervised-installer/releases/latest/download/homeassistant-supervised.deb apt install ./homeassistant-supervised.deb
Step 2: Resolving Potential Network Issues
- If you encounter a message like “Waiting for checkonline.home-assistant.io – Network interface might not be working…”, open a second SSH window and edit your DNS settings:
sudo nano /etc/resolv.conf
Scroll down to nameserver
and change its value to 1.1.1.1
. Save and exit (Ctrl + x
, then y
, and Enter
).
Step 3: Finalizing the Installation
- During the setup, you might be asked to choose a machine type. If so, select
generic-x86-64
.
- Installation typically takes up to 5 minutes but can vary. Be patient.
- You can monitor the setup progress by connecting to your computer’s IP address on port 8123 in a web browser (e.g.,
http://192.168.1.150:8123
).