Home Assistant Installation Methods

Home Assistant Installation Methods

Name Required Skills Includes Supervisor Supports Add-ons Supports Snapshots Includes Operating System Uses Docker Method
OS Minimal (1) :heavy_check_mark: :heavy_check_mark: :heavy_check_mark: :heavy_check_mark: :heavy_check_mark: Disk image (2)
Supervised Linux, Docker :heavy_check_mark: :heavy_check_mark: :heavy_check_mark: :x: :heavy_check_mark: Shell script (3)
Container Linux, Docker :x: :x: :x: :x: :heavy_check_mark: Docker container (4)
Core Linux :x: :x: :x: :x: :x: Python app (5)
Note Description
1 Ability to follow instructions to burn an SD card.
2 Burn disk image, for your model of single-board computer, to SD card or as a Virtual Machine.
3 Execute shell script on an existing instance of Debian linux on a dedicated machine.
4 Install docker container in an existing docker environment.
5 Install python app, preferably in a virtual python environment.
Docker vs running natively on OS
Which linux distro for Home Assistant
Hassio vs HomeAssistant % documentation confusion
My Home Assistant installations have come full circle, back to RPi
Ras Pi 4gb clean install on 3 different flash cards
HASS.IO inside docker?
Which installation type?
Installing hass.io in docker - where are the official doc?
How to migrate from hassio to docker
Install OS and home assistant?
Meaning of "OS" for a returner
Docker HA Supervisor Integration
Can't use python commands with home assistant
Missing parts of HA
New to home assitant installation
HA Installation Methods - Not to Beat a Dead Horse
Why are things so difficult?
Installing Addons on non-Pi Homeassistant machine
All Updates Fail
Multiple Home assistant supervisor in one machine
DeConz integration fail: "No module named 'pydeconz'"
Completely new to Home Assistant
Hass difficulty
How to start HA, won't restart
Pass Sensor value to Python Script, process it and return back as another Sensor value
Installing HA image with docker on synology NAS
HomeAssistant on Raspberry Pi/ SD-card image version
No Supervisor Panel Included
Migr. from Docker&SSL to VM&VPN
Install FUSE on Home Assistant OS
Install socat or ser2net on HassOS?
Advice Home Assistant + PiHole
Newbie Questions regarding initial setup
Not sure what I'm running
Keep network interfaces alive, but without hassio-supervisor.service an hassio-apparmor.serviced
HassOS for custom board (hardware)
Installing Home Assistant on an existing Raspberry PI 4 8GB Linux machine with a desktop?
Installing Home Assistant OS using Proxmox 7
Beginner friendly documentation
X10 automation?
Booting HA From an SSD on a PI4
Home Assistant Supervised Ansible playbook
Proper install to get ZWave/Zigbee to connect to Hyper-V hosted Home Assistant
RPi as Z-Wave/ZigBee-over-IP server for Hass
Hassio on Docker for Windows
Update to 0.117 just bricked my system
Supervisor UI and install on Raspbian
Pulling the Trigger
Installing Home Assistant OS using Proxmox 7
Very confused at this point
Install on Existing Raspberry Pi with other web services running
Install HA on PI 4 - SSD - Nothing happens
How to activate editor embedded in HA
Hass.io manual installation in virtual environment on Raspberry Pi
HA installation and Vlans
Finally upgraded home assistant. now everything is broken
New User... what do I need?
Supervisor + File Explorer
System Architecture Advice
How do I install on Ubuntu Server, No Documentation
How do I install on Ubuntu Server, No Documentation
Difference between hassbian and hassio
Totally confused and lost - Zigbee2MQTT
Synology DSM Docker and hass.io
Quick and easy way to setup external access to HA Core with hostname and ssl certificate
Home Assistant is making my PC non responsive
Problems with booting hass.io on Latitude E6410 laptop
Which way to go - NUC - Home Assistant
How to start HA, won't restart
Home Assistant Installation Methods - What For Who?
Hass.io reach IP? Weird IP
Nuc and Docker: HAOS in VM, performance, experience?
HA not following soft links for docker volume
Install HA on PI 4 - SSD - Nothing happens
Update of Home assistant or addons failed - system not healthy
Raspberry pi 400 & Hassio
Hassio Raspberry PI2
Running HA OVA virtual machine - trying to locate python
Home Assistant Core - HACS not find deConz plugin
Installed, set up, can't access Raspian now!
Where is the add-on store when running from docker?
Run HA as dedicated or shared OS?
Rasberry Pie died - New hardware, how to restore to Intel NUC
Add a graphical docker to the supervisor tab
Where is supervisor (Hassio) from home assistant installed via docker?
Install homeassistant 2021 in raspberry pi 4 os
Starting with Home Assistant
Installing additional dependencies
Installing Home Assistant Supervised on Debian 11
Hass vs HassIO - Configuration
Upgrade on pi4 hassio in a python virtual environment
Home Assistant installation
NUC install: HA OS image vs. Proxmox vs. HA Supervised on Debian
Running Home Assistant and FreePBX side by side on same Pi4
Supervisor or not!?
Best way to install on a NUC
After restart/time get message: "Unable to load the panel source: /api/hassio/app/entrypoint.js." when trying to access addons or supervisor and also can't update to 2021.1.5
Dyson not connecting anymore
NOOB, SSL raspberry pi VIRTUAL ENVIRONMENT, no port forward, no addons
Broken hass-supervisor
Problem Supervisor Add-On
Why is it so complex and difficult to install and maintain HomeAssistant?
Nevermind everyone :D Sorry for wasting your time...It was easier than I thought
HA running but not healthy!
Updating from HA(core) v0.104.3 - should I follow standand upgrade approach
Install HomeAssistant on Orange PI2+
Running Home Assistant OS on windows VM and add node MCU controlled by google assistant addon
Seasoned Hass User - Hass Installation Advice (Details Inside)
Access Home Assistant from outside house network
Installation Methods & Community Guides Wiki
Installing Home Assistant Supervised on Raspberry Pi OS
New Here - HassIO vs HassOS vs Home Assistant?
Home Assistant 0.110.4 & ESPHome
Time condition - inclusive or exclusive?
Why is a qemux86-64 emulator and not a native amd64 container?
Getting more confused by the minute!
Home Assistant shuts down without reason
Odroid C2, 'weird' CLI and bluetooth
Addon installation
Possible to run Home Assistant on Fedora 23
HDDTemp setup
Runing Home Assistant Supervised in LXC
A few basic questions
Sonoff not being recognized by Hassio
[On Hold] Deprecating Home Assistant Supervised on generic Linux
Add easier solution for loops in automations/scripts
UPB lighting
Question about beginners guide
[On Hold] Deprecating Home Assistant Supervised on generic Linux
Functionality Differences between HA OS and HASS.io?
Any good tutorial to add devices/scripts?

That is one of the clearest explanation of the various set ups I have seen, it has removed a lot of confusion for me. I am now clear I have the supervised system, that is or was, destined to be deprecated. since I really like my set up I guess I will have to change to OS to keep future updates etc. Am I correct in my simple summary?

Supervised will not be deprecated.

1 Like

If you have Supervised installed on Debian, that is the only distro of Linux that is officially supported according to ADR-0014.

If you have Supervised installed on some other distro, such as Ubuntu (like I do), then it is not officially supported. What does that mean? It means you will continue to be able to upgrade to new versions of Home Assistant and everything will work, until it doesn’t. When that happens (if ever), you will turn to the community for help because there will likely be other people who are running Supervised on Ubuntu.

If you run Supervised on some obscure distro, if something goes sideways you may have trouble getting community support. For the best support, it’s advisable to select the officially supported distro, namely Debian (as mentioned in the footnotes above).

1 Like

Thank you, Your documentation is always spot-on, clean & concise.

Thank you for the replies, I DO have the supervised version running on Ubuntu 18.04.2. So, I guess I ought to look at a move to OS. I have 4 machines running HA so an experimental move should not be too much of an issue.

The only bit I don’t like is that you have said that Required Skills for OS is “Novice”
This implies that “All you dumb newbies, please start over there”
(I know that’s not what you mean but a lot of people could interpret it that way)
Also, as most of the Devs seem to be running OS over Odroid ??? Then it’s also a bit inaccurate.
Why not just put “None” or “Suitable for Everyone” ?
Sorry to be picking holes, but it’s with ‘the aim to improveand I was the first to endorse this table when it first came up :smiley:


It’s like you didn’t even read the post by 123 that was two above yours…

Your install should be perfectly fine for a long time (probably…) and if you ever (if you ever do…) run into problems you can (likely…) get support here on the forums.

I like that better, too.

Or maybe to be more precise “Minimal”.

1 Like

That column represents the minimum IT skills required to perform the installation. It doesn’t represent the suggested audience for a given method. Someone who is familiar with managing Linux and Docker is free to choose any of the four installation methods.

In contrast, someone who is not comfortable with Linux and Docker will have a challenging, potentially frustrating, experience with Supervised, Container, and Core. Even if they muddle their way through the installation, they will still be challenged by maintaining Linux.

“None” would be misleading. You need some IT skills to install Home Assistant OS (certainly more than for installing a consumer-level product like Philips Hue Bridge).


I know you know that, and I know it too but it’s what you can imagine, some people ‘perceive’ when they land on the page. It takes a special mind set I’ll grant you but I know for a fact that you have encountered many such with the required attitude.
I’m just trying to head off the ‘negative vibes’ thing

I’m open to suggestions that concisely describe the following prerequisites:

  • Ability to download and install balenaEtcher.
  • Download disk-image file for the chosen SBC.
  • Use balenaEtcher to write disk-image to microSD card.

It’s not a task the average computer user performs but it’s not much of a stretch from basic computer skills:

  • Follow instructions.
  • Download files.
  • Install app.
  • Use app.

It terms of required skills it’s not “None” but a minimal set known by any competent person who uses a computer/phone/tablet.

I think that is too many words. I would have stopped at ‘Ability to follow instructions.’

I’m not sure if I like ‘novice’ either but that’s not what I posted to say :wink:

Right. That’s why I suggested “Minimal” above.

Thanks, that gave me a chuckle. Perhaps it can be reduced to “Can read.”

I’m fine with that. I’m waiting a few more ticks before changing it, just in case someone else suggests the perfect word to summarize the requisite skills.

Yeah, let this stew for a while … and then … open a Poll !



I fully read the post and understood it. My other remarks were on a personal basis of an option I am free to try. I undoubtedly will keep at least one machine on the present Supervised set up. I would also like to have system that the devs consider main stream.
Based on reading further posts I would have no difficulty downloading and installing an image for OS.

I’m late to the party regarding seeing this post. It’s a great table and should be part of the official docs

Fantastisk overview, should definitely be among the official documentation. Can anyone explain why one would choose Supervised (like I currently have on Ubuntu) over OS in a general matter?

And for my specific case, I don’t use the computer and don’t need to use the computer to anything other than Home Assistant. I don’t know how to utilise Docker and need to Google every step involving Ubuntu and Docker.

The best reason to choose supervised over OS is if your hardware doesn’t have a prebuilt OS image for it (like the mac mini I run on). Some other reasons I have are that I want to run RAID disks and none of the recommended hardware has 2 drive bays and I wouldn’t be sure that HassOS would support it. Also I have one component that needs access to the system to receive messages from systemd. I’m not sure this would work under hassos… There are many more reasons but those are the ones off the top of my head.

I don’t quite understand what you mean with prebuilt OS image? I thought it was as simple as download the image and use BalenaE to burn the image on the SSD? Or what am I not getting?