Home Assistant OS

Home Assistant OS is a Linux-based operating system optimized to host Home Assistant, a self-hosted smart home hub.

  • Home Automation
Home Assistant OS is a Linux-based operating system optimized to host Home Assistant, a self-hosted smart home hub. It uses Docker as its container engine to run the Home Assistant Supervisor, which in turn manages the Home Assistant Core and add-on apps in separate containers. Built with Buildroot rather than a standard Linux distribution, it targets single-board computers such as the Raspberry Pi as well as virtual machines, giving homelabbers a dedicated, maintained platform for self-hosting Home Assistant.

Platform availability

Available on 2 of 10 platforms

  • Unraid (not listed)
  • TrueNAS
  • Umbrel (not listed)
  • ZimaOS (not listed)
  • Proxmox
  • Helm (not listed)
  • Mac (not listed)
  • Windows (not listed)
  • Linux (not listed)
  • Any server (not listed)

Health score?A 0-100 score computed nightly from four factors: maintained (40%: recent commits and steady activity), popular (25%: GitHub stars, log scale), easy to install (20%: platforms, install notes, setup guides, Docker image) and light to run (15%: minimum RAM, ARM support). When the source code has been checked, a fifth factor, security check (20%: automated scan for committed secrets, unsafe desktop-app settings, known-vulnerable dependencies and project hygiene; any serious finding caps it at 20), is added. Factors without data are left out and the rest are rescaled.

63/100 Good

Maintained
100last commit 5 days ago
Popular
787,681 GitHub stars
Easy to install
150 install platforms, install notes
Light to run
No data
Security check
201 serious finding, CI, tests, OpenSSF Scorecard 6.7/10

Based on 4 of 5 factors.

GitHub stars
7,681
Open issues
107
Last commit
2026-11-16
Latest release
18.5
License
Apache-2.0
Activity
steady

Checked 3 days ago - source: GitHub (home-assistant/operating-system)

Resources & Compatibility

Requirements not published yet.

First-install notes

  • Use port 8123 to reach Home Assistant The API examples connect to Home Assistant at http://localhost:8123, so allow port 8123 in your router or firewall. If that port is blocked, you cannot open the web dashboard or make API calls. source
  • Back up the settings folder early The API config response includes config_dir, which shows where Home Assistant stores its settings folder. Keep that folder safe or backed up, because if it is lost you can lose your devices, automations, and customizations. source
  • Find the dashboard address after installation The installer script sets up the software automatically on your server. Once it finishes, check the Summary tab for the web address, then open it in a browser (default port 8123) to start managing your home. source

Fetched 42 days ago - each note links to its source

Alternatives (12)

  • Domoticz - Domoticz is a free, open-source home automation system that lets you monitor and control lights, switches, sensors, and smart devices, with…
  • Gladys Assistant - Gladys Assistant is a privacy-first, open-source home assistant for self-hosted users that centralizes connected devices, visualizes data o…
  • Google Home - Easily control Chromecast and Google Home devices, manage settings, sync with smart devices, and discover new features with this comprehens…
  • Home - With the new Home app, you can securely control all your Homekit accessories from your favorite iOS device.
  • Home Assistant - Home Assistant is an open-source home automation platform that keeps all data local and private with no cloud dependency.
  • Homebridge - Homebridge is an open-source bridge that makes smart-home devices work with Apple HomeKit.
  • Homey-Wan-Kenobi-MCP - Homey-Wan-Kenobi MCP is a self-hosted Model Context Protocol (MCP) server that lets local language-model assistants control Homey Pro smart…
  • SmartThings - Effortlessly manage home devices with voice control, create routines, monitor remotely, and track energy usage.
  • fhem - FHEM is a self-hosted home automation server written in Perl that lets homelab users control devices, view sensor data, and automate routin…
  • ioBroker - ioBroker is an open-source IoT platform that gives you a graphical web interface to configure, automate, and control your smart-home and ho…
  • jeedom - Jeedom is a smart home hub that lets you control devices like lights and heating from one place.
  • openHAB - openHAB is a vendor- and technology-agnostic open-source home automation platform.

Checked 40 days ago - source: AlternativeTo

Common questions

Does Home Assistant OS run Home Assistant and apps as Docker containers?

Yes. It deploys the Supervisor as a container, and the Supervisor uses Docker to run Home Assistant Core and apps in separate containers.

Which bootloaders are used by Home Assistant OS?

It uses GRUB for devices that support UEFI and U-Boot for devices that do not.

Answers sourced from github.com

Community

Collected 48 days ago - public community threads