Guide to Setting Up Home Assistant Supervised on Debian

Section 1: Preparing Your System

Step 1: Update Debian and Install Docker

  1. Open your terminal (or connect via SSH using Putty). Start with root privileges:sudo -i
  2. Update your system and remove unnecessary packages:apt update && sudo apt upgrade -y && sudo apt autoremove -y
  3. Fix broken installations:apt --fix-broken install
  4. Install necessary dependencies:apt install apparmor jq wget curl udisks2 libglib2.0-bin network-manager dbus lsb-release systemd-journal-remote systemd-resolved -y
  5. Install Docker using the following command:curl -fsSL | sh

Step 2: Updating OS Agent

  1. Go to the Home Assistant OS Agent GitHub page and note the latest version number.
  2. Replace 1.6.0 in the command below with the latest version you found:
    wget dpkg -i os-agent_1.6.0_linux_x86_64.deb
    for debian 12 arm64
    wget dpkg -i os-agent_1.6.0_linux_aarch64.deb

Section 2: Installing Home Assistant Supervised

Step 1: Setting Up the Installation

  1. Ensure you are working as root (especially if you have rebooted after Section 1):sudo -i
  2. Download and install the Home Assistant Supervised package:wget apt install ./homeassistant-supervised.deb

Step 2: Resolving Potential Network Issues

  1. If you encounter a message like «Waiting for — Network interface might not be working…», open a second SSH window and edit your DNS settings:sudo nano /etc/resolv.confScroll down to nameserver and change its value to Save and exit (Ctrl + x, then y, and Enter).

Step 3: Finalizing the Installation

  1. During the setup, you might be asked to choose a machine type. If so, select generic-x86-64.
  2. Installation typically takes up to 5 minutes but can vary. Be patient.
  3. You can monitor the setup progress by connecting to your computer’s IP address on port 8123 in a web browser (e.g.,