It is both.
Home Assistant created an OS for appliance like installations.
But there is also the docker images, repo packages (I know Arch Linux has it in the repo) and pip based packages too.
Home Assistant is open source home automation that puts local control and privacy first. Powered by a worldwide community of tinkerers and DIY enthusiasts. Perfect to run on a Raspberry Pi or a local server. Available for free at home-assistant.io
It is both.
Home Assistant created an OS for appliance like installations.
But there is also the docker images, repo packages (I know Arch Linux has it in the repo) and pip based packages too.
I installed it on my home Ubuntu server many years ago. Every now and then I get notification in HA, that my OS is unsupported. And if I want to update HA, add-ons or Supervisor, I can't, because "Docker is misconfigured" - I have Portainer installed. In order.to update, I have to stop Portainer and restart HA Supervisor. HA itself works, but sometimes I don't get it. Especially the Portainer bit.
Maybe you where on an older Ubuntu LTS. I don't know which Ubuntu they consider "supported".
I've been running my HA in Docker on Arch Linux for the last 4-5 years and I have never been notified that my OS is unsupported. Could be portainer related.
For some reason, on Ubuntu, the Supervisor container loses its “privileged” status. I’m not sure if it periodically restarts itself or something , but that also was happening to me.
I moved my setup to Debian 12, did a fresh Supervised install, and then restored a full backup from my Ubuntu instance and I haven’t had this issue since.
Home Assistant has a lot of moving parts, all the add-ons and extra user stuff. So they provide a docker image with everything you need, they also provide a full appliance install for easy setup.
If you did all that as a package install, you would complain about all the dependancies and if you didnt install the right version of something Home Assistant might not work at all
Before I understood Docker, I used to have HA installed directly on bare metal side by side with other "desktop" apps.
To be able to access devices, HA needs many different OS-level configurations (users, startup, binding serial ports, and much more I don't have a clue about). It was a giant mess. The bare OS configuration was polluted with HA configurations. Worse, on updating HA, not only did these configurations change, the installation of HA changed enough that every update would break HA and even the bare OS would break in some ways because of configuration conflicts.
Could this be managed properly through long term migration? Yeah, probably, but this is probably a ton of work, for which a purpose-built solution already exists: Docker. Between that and the extra layer of security afforded by dedicating an OS to HA (bare metal or virtualized), discouraging the installation of HA in a non-dedicated environment was a no brainer.
this is probably a ton of work, for which a purpose-built solution already exists: Docker
LOL Docker isn't a "solution" to the pressure of good engineering.
What do you mean with "Operating System"?
It is most often installed as Docker container, which isn't an OS, but just includes all dependencies to run. You still need an OS (like Debian) as host.
SystemHome Assistant OS, the Home Assistant Operating System, is an embedded, minimalistic, operating system designed to run the Home Assistant ecosystem. It is the recommended installation method for most users.
What do you mean with "Operating System"?
If I go to
https://www.home-assistant.io/
and click on "Installation", ignoring the custom Home Assistant hardware, the first relevant section is "DIY with Raspberry Pi" whose tutorial has a section "Install Home Assistant Operating System".
The second relevant section of the Installation page is "Install on other hardware" with a paragraph whose second sentence is "The Home Assistant Operating System allows you to install Home Assistant on these devices even if you have little to no Linux experience."
It's most often installed as HAOS, which is a dedicated operating system that just runs Home Assistant. That is how anyone installing it on say, a Raspberry Pi, is likely to do it.
Home Assistant as a project is far more popular than every single other consumer focused server and as such it is often the first home server (and sometimes only) that many consumers will experience.
I installed it on Ubuntu server on my raspberry pi 4 and it took a couple months to fall over and become useless.
I've been running their OS since then and it has been absolutely rock solid. It's been 5 or 6 years now, all I do is add more devices occasionally and update it when it occurs to me.
If you have a life and you don't absolutely love tuning your OS for special purposes in ways that are already solved problems, the hass os image is the way to go.
Look into "install home assistant core" on https://www.home-assistant.io/installation/linux
You should ask this to your favourite distro packagers, not to the home assistant developers.
In any case, it is such a mess of dependencies due to load of optional packages, very active development, that continuously break dependencies on the package repo.
What advantage would bring have a most of the time obsolete distro specific repo? On a maintainer POV this is the typical use case for distro agnostic deployment, maybe flatpak, maybe docker.
It's true some things are harder to do in the container configuration; it's easier installed as an OS, especially integrations like Z-Wave, ZigBee, RTSP, Eufy, ESP, and so on. All of these require running other software, and in containers it's a fair bit of fussing with port and host OS device connections.
I've always run it in a container, without issue. It works fine, but I'm comfortable with the command line and LXC. That said, flashing an ESP hardware device and getting it connected to HA running in a container has so far defeated me, because I have to give access to the device in the configuration of the container before I run it, but the device flashing process itself is time limited and expects a process to be waiting on it when it is connected. It's a chicken/egg problem I haven't yet figured out which wouldn't be a problem if I were running the HA OS.
HA isn't the only software that just works better when it controls the while OS. Kodi is another that encourages users heavily to running it as an OS.
Regardless, it runs fine via
podman pull ghcr.io/home-assistant/home-assistant: latest
and there's a package in AUR that wraps the container up with a systemd service - it's as close to a bare package install as you're likely to get.
What's a little funny to me is that, despite that I've been running HA in a container for the past 4 years, I'm working towards getting a dedicated device and running HA OS on it. If we ever move out of this house, I'm not going to spend weeks going around replacing all of the hardware - smart sockets, lights, garage door opener, security, etc etc - with dumb devices; and for any of that to be worth anything, it's going to need a controller configured for it, which means, I'm planning on selling the HA server device with the house. For that case, I don't want anything but HA running on that device, and for that, it'd just be easier and smoother to run HAOS.
My advice is to run HA in a container until you are sure that's the direction you want to go, but not for so long that it's going to be a PITA to migrate to a dedicated server. But - hey, just IMHO - plan on running HAOS. If I knew then what I know now, that's what I would have done.
It can also be installed using docker containers but that is more difficult to manage as you have to install every component manually.
That’s not how docker works, bud.
I guess that my message wasn’t clear but by “component” I meant a home automation component.
I have the following containers in my HA installation:
And maybe others that I have forgotten.
Each had to be installed manually by adding it to my docker compose file, mapping drives, and editing config files.
Most, if not all, of them (except HA) can be installed from within HA if you’re using HAOS.
Ah, that makes a lot more sense.
@nogooduser @rah I'm currently running it in docker, and it's taught me a lot about docker, but it's a hell of a technical overhead every time you want an addon.
The documentation very strongly steers you to a whole-os install, and I don't like that, but I'm tempted. I may well succumb and pick the HA image for my raspberry Pi, start over
The one thing that was a misstep on my docker journey was that the original tutorials that I followed installed them using the command line. It’s much better to do it using a docker compose file.
@nogooduser Oh yes, I agree. Docker documentation is so random. Once I discovered that later versions of compose could inline the buildfile, I realised that was clearly the way to go. But you have to hunt through the docs to find it.
Yep, that's how my install is, running Debian, home assistant in containers (core, supervisor, more)
@rah There are tons of applications which can be installed via git clone and make instal using a isolated environment like pyenv or others. So I agree.
Now I get an Haos and docker thingy which is very restrictive on most types of installs. If installed different than the maker wants, no addons or more restrictions.
Home assistant is in the top 10 most popular and active open source projects.
@Rah, you need to pull your head in with your repeated assertion that it is poorly engineered simply because it doesn't use a particular distros packaging system. Perhaps you haven't used it enough to fully appreciate the things HA does?
The devs are listening to their customers who value: ease of use, reliability, stability and security in the system which orchestrates the iot devices in their home or workplace.
HA often runs exposed to the internet, has a catalog of thousands of integrations and a good hundred add-ons, (before we even get into the HACS community store), has its own desktop and mobile and even watch apps. Each of these components and configurations may be backed up and updated within HA itself with no external dependency. Yet the team and volunteer devs remarkably manage this complexity and release features and changes almost every week.
Initially the project was a lot more flexible in supporting bare scripted installs. I used to run a custom supervised installation myself, managed lots of entries in a configuration.yml, however this mode of installation and operation was deprecated as the project matured. I believe it was the right call to make.
As the project's popularity grew amongst smart home enthusiasts and vloggers and started to reach the general populace who might have never touched Linux or a command-line before, supporting all that demand meant that tighter controls were necessary to define what a 'supported' system and environment was. That is, a predictable and reproducible environment at millions of installations.
The solution is to recommend users install the system as a complete appliance, an entirely contained, managed and controlled operating system HASSOS, on bare metal or as a virtual machine. Or fallback to HA Core if the user is comfortable managing Docker. Experienced Linux users who want to spend time managing dependencies themselves are no longer the primary audience or user base for Home Assistant, but are still free to do so if they accept zero support and various warnings.
Hope that helps and wasn't a waste of time explaining.