codetomake.com

Installation - Home Assistant

2025.07.04 14:50



2025.7.0 Getting started Documentation Installation Automations Dashboards Voice assistants Device organization Energy management Advanced configuration Integrations Blog Need help?

On this page

About installation methods Plug and play with Home Assistant Green Home Assistant Green DIY with Raspberry Pi Install Home Assistant on Raspberry Pi Extend with Home Assistant Yellow Home Assistant Yellow Install on other hardware Install Home Assistant on Odroid devices Install Home Assistant on x86-64 machines Install Home Assistant variants on Raspberry Pi Install Home Assistant on Linux Install Home Assistant on macOS Install Home Assistant on Windows Install Home Assistant on other systems Deprecated installation methods

Installation

The first step to getting started with Home Assistant is to install it on a device. There are many ways to run it for all kinds of scenarios and all kinds of skill levels.

About installation methods

Home Assistant offers two different installation methods. Home Assistant Operating System is the recommended installation method.

Home Assistant Operating System : An embedded, minimalistic operating system designed to run the Home Assistant ecosystem on single board computers (like the Home Assistant Green or a Raspberry Pi) or Virtual Machines. It is the most convenient option in terms of installation and maintenance and it supports add-ons Add-ons are additional standalone third-party software packages that can be installed on Home Assistant OS. [Learn more] . Home Assistant Operating System is the recommended installation method for most users. Home Assistant Container: Container-based installation of Home Assistant. You need to bring your own system (such as Linux) with container orchestration (like Docker), and manually handle updates. Home Assistant Container installations don’t have access to add-ons Add-ons are additional standalone third-party software packages that can be installed on Home Assistant OS. [Learn more] . HA OS 1 Container 1 Automations Dashboards Integrations Add-ons Blueprints One-click updates Backups 1: Names are abbreviated. The full names of the installation methods are: Home Assistant Operating System Home Assistant Container

Easiest

Plug and play with Home Assistant Green

The affordable Home Assistant Green is the easiest way to start using Home Assistant. It's plug-and-play and comes with Home Assistant already installed.

Home Assistant Green

The easiest way to get started with Home Assistant

SKILLS REQUIRED Interest in setting up a smart home TOOLS REQUIRED Ethernet connection Get Home Assistant Green View tutorial Easy

DIY with Raspberry Pi

Raspberry Pi, a mini low-cost computer, is one of the most popular platforms for running Home Assistant. If you want to learn how to DIY, this is a good way to start and gain experience.

Install Home Assistant on Raspberry Pi

A low-cost DIY solution to get started with Home Assistant

SKILLS REQUIRED Assembling a Raspberry Pi setup Flashing a Raspberry Pi TOOLS REQUIRED Raspberry Pi 4 or 5 with power supply MicroSD card Ethernet connection Get Raspberry Pi View tutorial Intermediate

Extend with Home Assistant Yellow

The extensible Home Assistant Yellow comes with all the ingredients you need to help you build a robust smart home. All you need to do is to bring your own Raspberry Pi Compute Module.

Home Assistant Yellow

The powerful way to run Home Assistant

SKILLS REQUIRED You're comfortable following instructions on: Installing a compute module and a heat sink Flashing a Raspberry Pi TOOLS REQUIRED Raspberry Pi Compute Module 4 Ethernet connection USB storage drive Screwdriver Get Home Assistant Yellow View tutorial Hard

Install on other hardware

Home Assistant can be repurposed and installed on various hardware, such as an Odroid or a generic x86-64 machine. The Home Assistant Operating System allows you to install Home Assistant on these devices even if you have little to no Linux experience.

Install Home Assistant on Odroid devices

A more powerful alternative to Raspberry Pi

SKILLS REQUIRED You're comfortable following instructions on: Writing boot images Installing an SD card or eMMC TOOLS REQUIRED An Odroid device MicroSD card or eMMC Ethernet connection View tutorial

Install Home Assistant on x86-64 machines

Repurpose workstation hardware to run Home Assistant

SKILLS REQUIRED You can use a command line and install a boot medium on your hardware You're comfortable configuring the BIOS based on instructions. TOOLS REQUIRED An x86-64 machine Storage hard drive USB stick Ethernet connection View tutorial Expert

Install Home Assistant variants on Raspberry Pi

A low-cost DIY solution to get started with Home Assistant

SKILLS REQUIRED Assembling a Raspberry Pi setup Flashing a Raspberry Pi Advanced knowledge of Linux Using Linux command line TOOLS REQUIRED Raspberry Pi 3, 4 or 5 with power supply MicroSD card Ethernet connection Get Raspberry Pi View tutorial

Install Home Assistant on Linux

Use Home Assistant OS, Container

SKILLS REQUIRED Advanced knowledge of Linux Using Linux command line Using Docker Compose (for HA Container) TOOLS REQUIRED Machine with Linux installed View tutorial

Install Home Assistant on macOS

Use Home Assistant OS on a VM

SKILLS REQUIRED Advanced knowledge of macOS Using macOS command line TOOLS REQUIRED Machine with macOS installed View tutorial

Install Home Assistant on Windows

Use Home Assistant OS on a VM

SKILLS REQUIRED Know how to find an IP address on your router Advanced knowledge of Windows Using Linux command line TOOLS REQUIRED Machine with Windows installed VirtualBox (for VM) View tutorial

Install Home Assistant on other systems

Use Home Assistant on virtual machines, NAS, and more

SKILLS REQUIRED Know how to find an IP address on your router Advanced knowledge of Windows Using Linux command line TOOLS REQUIRED Machine with Windows installed VirtualBox (for VM) View tutorial

Deprecated installation methods

Home Assistant used to offer two additional installation methods for advanced users: Home Assistant Core Home Assistant Core is the Python program at the heart of Home Assistant. It is part of all installation types. It can be installed standalone (without Home Assistant Supervisor) as a container using Docker (this is typically referred to as the Home Assistant Container installation method). For development, Core can also be run using a Virtual Environment (previously referred as the Home Assistant Core installation method. For production setup, the [Home Assistant Core installation method is deprecated](https://www.home-assistant.io/blog/2025/05/22/deprecating-core-and-supervised-installation-methods-and-32-bit-systems/). and Home Assistant Supervised The Home Assistant Supervised installation method is a full UI managed home automation ecosystem that runs the Home Assistant Core program, the Home Assistant Supervisor and add-ons. It comes pre-installed on Home Assistant OS, but can be installed standalone on Debian Linux systems. It leverages Docker, which is managed by the Home Assistant Supervisor. The [Home Assistant Supervised installation method is deprecated](https://www.home-assistant.io/blog/2025/05/22/deprecating-core-and-supervised-installation-methods-and-32-bit-systems/). . These two methods are now deprecated and no longer recommended for new users .

Home Assistant Supervised: Manual installation of the Supervisor. Home Assistant Core: Manual installation using Python virtual environment.

Help us improve our documentation

Suggest an edit to this page, or provide/view feedback for this page. Edit Provide feedback View given feedback

Getting started

Installation Home Assistant Green Home Assistant Yellow Raspberry Pi ODROID Generic x86-64 Linux macOS Windows Other systems Troubleshooting Onboarding Concepts and terminology Editing the dashboard Adding integrations Automating devices Presence detection Join the community Next steps

On this page

About installation methods Plug and play with Home Assistant Green Home Assistant Green DIY with Raspberry Pi Install Home Assistant on Raspberry Pi Extend with Home Assistant Yellow Home Assistant Yellow Install on other hardware Install Home Assistant on Odroid devices Install Home Assistant on x86-64 machines Install Home Assistant variants on Raspberry Pi Install Home Assistant on Linux Install Home Assistant on macOS Install Home Assistant on Windows Install Home Assistant on other systems Deprecated installation methods

Home Assistant is a project from the Open Home Foundation , sponsored by Nabu Casa .

Join us and contribute!

GitHub repo Developers Portal Design Portal Data Science Portal Community Forum Creator Network Works With Home Assistant Reporting issues

System status

Integration Alerts Security Alerts System Status

Companion apps

iOS and Apple devices Android and Wear OS and more!

Governance

Privacy Notices Contributor License Agreement Terms of Service Code of Conduct Credits License

Follow us

Sign up for our newsletter



Contact us here for media and partnership inquiries. (No technical support!)

Website powered by Jekyll
Originally based on the Oscailte theme