Installing Home Assistant Supervised on a Raspberry Pi with Debian 10

Tags: #<Tag:0x00007fc414c3d590>

Installing Home Assistant Supervised on a Raspberry Pi with Debian 10

This guide will help you to install Home Assistant Supervised, on a Raspberry Pi with Debian 10. This guide has been tested on a Raspberry Pi 4 4gb model, with USB3 SSD as the boot drive. This installation takes approx 45 mins to complete, but may be faster/slower depending on the boot drive you use and your internet speed. I completed the install in under 20 mins with the above hardware.

:warning: Using Debian 10 and following a strict set of guidelines available HERE will give you an officially supported installation of Home Assistant Supervised. If you choose at anytime to install additional software to the Debian operating system, your installation will become officially unsupported. Community support via the forums is always available however.

While every effort has been made to ensure this guide complies with ADR-0014, no guarantee can be made it does now, or in the future.

In this guide, you will be using Debian 10 as the operating system. This type of installation is what is called “headless” and after the installation is complete, you will not need to have a keyboard, mouse or monitor attached (although you can if you prefer).

What is Home Assistant Supervised?

Home Assistant is a full UI managed home automation ecosystem that runs Home Assistant Core, the Home Assistant Supervisor and add-ons. It comes pre-installed on Home Assistant OS, but can be installed on any Linux system. It leverages Docker, which is managed by the Home Assistant Supervisor plus the added benefit of dozens of add-ons (think app store) that work natively inside the Home Assistant environment.

If you are new to Home Assistant, you can now proceed to Section 1. If you have an existing Home Assistant installation and need to know how to back up your current configuration, please see the document Backing up and Restoring your configuration located HERE

Section 1 – Install Debian

1.1) Start by downloading the correct xz-compressed image for your Pi from HERE. For a Pi 4, you will need the image listed as 4 under Family

1.2) While Debian is downloading, you will need to download some software to burn the Debian xz-compressed image to your SD Card / USB SSD. You will use a program called balenaEtcher, available HERE. Once the Debian image has downloaded, insert your SD Card / USB SSD into your PC and launch Etcher.

Click Select Image and navigate to the location you saved the Debian xz-compressed image, Click Select Target and then choose your SD card / USB SSD, and then click Flash. Depending on the speed of your card / drive this process can take between 1 and 20 minutes to complete.

1.3) Once the image has been written to the SD card / USB SSD, you can safely remove the SD card / USB SSD and plug it into your Pi. Before powering on the Pi, you will need to connect a Network Cable, HDMI cable, Monitor and a keyboard. Once you have done this, you can connect the power cable to your Pi. The initial boot will take a few minutes to complete. When the Pi is ready to use, you will see a screen that looks like this (or similar).

Debian GNU/Linux 10 rpi4-20210210 tty1
rpi4-20210210 login:

When you see this, you can now login using the default username of root.

1.4) First, you will make sure the OS is up to date by entering the following commands one at a time. The first command is a temp fix to resolve SSD boot issues after updating the OS, thanks @Tamsy.

apt-mark hold linux-image-arm64
apt update && apt upgrade -y
apt install sudo -y

1.5) You will now add a username and make that user part of the sudo group. To do this, run the following commands


You will now be asked to enter a password twice (make note of this for later). You will then be asked to enter your first name, last name, phone number etc. You can skip through all this by pressing Enter. Now you have added your user, you will need to make it part of the sudo group by running the following command.

usermod -aG sudo YOUR_USERNAME

You will now be able to connect to the Pi via SSH using the username and password you have just created to copy and paste the commands needed to install Home Assistant Supervised. Check your router for the IP address of your Pi, or run the following command in the Terminal and look for the entry inet. You don’t need the /24 or /16 on the end, just the IP which will look like, or

ip addr show eth0

To connect to your Pi via SSH you will use a piece of software called PuTTY (use Terminal on a Mac), available HERE. Putty is a free and open-source terminal emulator, serial console and network file transfer application.

You can now unplug the Monitor, HDMI cable and keyboard as these are no longer needed, or leave them connected if you wish.

1.6) Open Putty and in the HOST NAME (OR IP ADDRESS) box, enter the IP of your Pi, then select OPEN. You will now be prompted to enter your username and password. This will be the username and password you just setup in step 1.5.

Section 2 – Install Home Assistant Supervised

With Debian installed, you can move on to installing Home Assistant Supervised.

2.1) Copy and paste each line of the below commands into the Putty window one at a time, and press Enter.

sudo -i

apt-get install -y software-properties-common apparmor-utils apt-transport-https ca-certificates curl dbus jq network-manager

systemctl disable ModemManager

systemctl stop ModemManager

curl -fsSL | sh

curl -sL "" | bash -s -- -m raspberrypi4-64

If you are using a Raspberry Pi 3, then replace raspberrypi4-64 with raspberrypi3 at the end of the last command.

2.2) The installation time is generally under 5 mins, however it can take longer so be patient. You can check the progress of Home Assistant setup by connecting to the IP address of your machine in Chrome/Firefox on port 8123. (e.g.

Once you can see the login screen, the setup has been completed and you can set up an account name and password. If you are new to Home Assistant you can now configure any smart devices that Home Assistant has automatically discovered on your network. If you have an existing Home Assistant install and you have a snapshot or YAML files you wish to restore, refer to the document Backing up and Restoring your configuration.

You have completed the installation of Home Assistant Supervised on your Raspberry Pi running Debian. It is recommended that you log into your machine at least once a month and use the following command to download security patches and keep the OS up to date.

sudo apt update && sudo apt upgrade -y && sudo apt autoremove –y

You can do this directly on the Pi itself with the Monitor and Keyboard attached, or via Putty.

I welcome feedback on this guide, please feel free to tag me or PM if you have suggestions on how to make improvements, or find an error that needs correcting.

Installing Home Assistant Supervised on Raspberry Pi OS
Installing Home Assistant Supervised on Debian 10
Install HA on PI 4 - SSD - Nothing happens
Rpi 4 installation
Install homeassistant 2021 in raspberry pi 4 os
Fix unsupported installation in supervisor
Install socat to new Home Assistant Blue
Raspberry OS or Home Assistant OS
Getting NetworkManager/HA IP settings to work properly on a supervised 64 bit Raspberry Pi OS install
Home Assistant installation
Raspberry OS or Home Assistant OS
Installing Home Assistant Supervised on Debian 10
Installing HA on a Raspberry Pi
How can i install older versions?
Installing Home Assistant Supervised on Debian 10
HA does not boot off new Flashed card
Why is it so complex and difficult to install and maintain HomeAssistant?
Why is it so complex and difficult to install and maintain HomeAssistant?
No valid repository for
Wrong system time&date - HA on Pi4
TileBoard - New dashboard for Homeassistant
Installation on Docker
Basic Information Required
Installing Home Assistant Supervised on Debian 10
Unable to update core and supervisor
The MAC address changes on every reboot on Raspbian Lite after installing Home Assistant
Google Nest Intergration Problem
No valid repository for
Why is it so complex and difficult to install and maintain HomeAssistant?
Installing Home Assistant Supervised on Raspberry Pi OS
Containers being deleted on reboot
Supervisor fails
Another 'HomeAssistantCore.update' blocked from execution, system is not healthy issue
Installing Home Assistant Supervised on Raspberry Pi OS
Nginx Reverse Proxy Set Up Guide – Docker
Installing Home Assistant Supervised on Debian 10
Home assistant stopped responding; GUI not reachable
✔️🆒Argon One Active Cooling Addon
Rasberry Pi B+ installation - docker not installing
Database location in usb stick
Newbie Questions regarding initial setup
Static IP address changes by another system dhcp deamon?
Static IP address changes by another system dhcp deamon?
Can't install

Well timed - I am just preparing to move from a Raspberry Pi OS SSD install to a supported (for the moment) Debian 10 one. This will save me a bit of stress - thanks.

1 Like

Hi, Thank you very much. I’ve just moved my system from Pi3+ to SSD / Pi4 4GB and thanks to your excellent presentation everything went smoothly including restore.
However, when everything seemed to be a success, an unexpected problem arose.
Have I missed something? After the update to the latest 0.118.2 I cannot create any snapshot. I restored a system from the snapshot which I copied via samba to PI4 backup folder. Could I have messed something there?

I am not sure if this is a coincidence, but via SMB I deleted the backup from Pi3 + and going back to HA I see that the new backup has been saved.

Might have just been a browser cache issue not showing the new snapshot. Are you able to successfully make a snapshot now?

Yes. Everything runs smoothly. Thanks again. And now I see that I missed those 3 dots in a right upper corner “Upload snapshot”, easier way to go.

1 Like

That’s only a recent addition to HA, in 0.116.x or 0.115.x, I can’t remember. Certainly makes things easier than needing to set up Samba or SSH config to restore.

Great guide and you could not have timed it better - Like I always tell my HA community pals - Kanga_who? Kanga, the man!
Quick Note: Could you mention someplace that the pi4 image is 64bit (I looked-it up on the screenshot) - it is gravy for those with a pi4 8gb.
Stay blessed!

1 Like

That’s why I made the default 64bit, as it will work on any Pi4. Next update I make to the instructions I’ll make a note of it.

Thanks for the feedback, glad to hear the guides help you :slight_smile:


Just completed this install - in under 15 minutes flat! Went like clockwork!
Points to note (for the readers of this thread):

  • 64bit Debian GNU/Linux 10 (buster), no desktop, CLI only.
  • Tiny 340mgs image size
  • Supported install :slight_smile:
  • No double-dance with SD and SSD or other hacks - I installed directly on an SSD conncted to USB 3 port of a pi4 8gb (with an updated bootloader, of course).

Thanks again, Kanga_who!


Hi. After following to the letter and accessing the host: 8123 and seeing that the page does not load, I decided to do a journalctl -f and it shows me these errors:

-ERROR (MainThread) [supervisor.homeassistant.core] Can’t start Home Assistant!
-INFO (SyncWorker_4) [supervisor.docker.interface] Cleanup images: [‘homeassistant/raspberrypi3-64-homeassistant:landingpage’]
What could I be doing wrong?

Try without the 64

Thanks for the quick reply!
curl -sL “” | bash -s – -m raspberrypi3

**So would it be well written?


Thanks for the guide
I have done the installation on a raspberry pi 3 b and everything is perfect. It works perfectly in a SSD of 64Gb
But when I shutdown - r now or reboot debian, it gets stuck in
sd 0:0:0:0 [sda] Attached SCSI disk
and it does not advance anymore
What can I do for solve?

At a guess, the SSD is not being detected at boot. if you have access to the console, run this.

sudo nano /sys/module/usb_storage/parameters/delay_use

The default value is 1, try changing it to 5, save, exit and reboot.

You may need to start with a fresh install and do this change before doing anything else, and try a reboot and see if it comes back up. If it does, you can move on to OS updates and installing HA.

edit: Actually, that doesn’t seems to work testing it myself, the value defaults back to 1 on reboot. It’s likely the USB adapter you are using is not compatible, and you may need to try another one. I’ve had a similar issue in the past with cheap USB adapters - the boot sometimes and not others.

the adapter is a Ugreen,
What adapter should I buy that is compatible and will work for me?

But the first time in the installation it starts perfectly

I use these Kingspec USB-C SSDs, they works very well with a Pi3 or 4 from my experience, they are an all-in-one and quite cheap.

This page may also be able to help get your existing drive working, or give you some options for adapters that are known to be working, perhaps yours is on the list and needs some config to enable it.

Thank you very much for the help
the ssd disk, which you use, have you tried it on a raspberry pi 3B?
and it works fine?

I have gotten it to boot after reboot with the same adapter
You have to change the /boot/cmdline.txt part of root=LABEL=RASPIROOT
by root = PARTUUID = XXXXXXXX-02
which you get by typing when you first install “blkid”
To make the change, you can do it with the SSD disk placed in a PC

1 Like


first of all thanks for the work.

It worked for me but I had a problem with the date on the pi at first. When I did the “apt update && upgrade” it gave me an error about Buster isn’t a valid stable release. I took me a while to figure out that the raspi4 was sitting on an old date (Feb 2019). After I’ve corrected the date with “date -s 2020-11-30” it all went smooth.

Thanks again

1 Like