Home Assistant OS
Home Assistant runs on a Home Assistant Green or Yellow, a Raspberry Pi or a mini-PC.
Home Assistant OS guideInstallation
Pick your case below. The setup wizard then asks for your free license and the Home Assistant connection.
Home Assistant runs on a Home Assistant Green or Yellow, a Raspberry Pi or a mini-PC.
Home Assistant OS guideYou have a Synology NAS: everything is done with the mouse, in Container Manager.
Synology guideYou know Docker: NAS, mini-PC, Raspberry Pi or Linux server.
Command-line guidePaste our installation sheet into ChatGPT, Claude, Gemini or Le Chat: the AI guides you step by step on your own hardware, all the way to remote access.
Before you start
After installation
The setup wizard opens by itself.
Free license, Home Assistant, meter, electricity plan. Every step can be skipped.
Regulation then starts. See getting started.
Updates
Your settings, license and history live in the data folder: an update does not touch them. The interface tells you when a new version is out.
The community answers on Discord, and the FAQ covers the most common questions.