7.5 KiB
| title | description | installation_type |
|---|---|---|
| Raspberry Pi | Install Home Assistant on a Raspberry Pi | raspberrypi |
{% comment %} Included section for this page is located under source/_includes/installation {% endcomment %}
{% assign board = "Raspberry Pi" %} {% assign installation_media = "SD card" %}
Please remember to ensure you're using an appropriate power supply with your Raspberry Pi. Mobile chargers may not be suitable, since some are designed to only provide the full power with that manufacturer's handsets. USB ports on your computer also will not supply enough power and must not be used.
Before installing Home Assistant, you might want to compare installation methods. Most notably, add-ons are only available with the Home Assistant Operating System.
Suggested Hardware
We will need a few things to get started with installing Home Assistant. Links below lead to Amazon US. If you’re not in the US, you should be able to find these items in web stores in your country.
- Raspberry Pi 5
- Raspberry Pi 4 (Raspberry Pi 3 Model B is ok too, but the Model A does not have enough RAM). Raspberry Pi are currently hard to come by, use RPilocator to find official distributors with stock.
- Power Supply for Raspberry Pi 4 or Power Supply for Raspberry Pi 3
- Micro SD Card. Ideally get one that is Application Class 2 as they handle small I/O much more consistently than cards not optimized to host applications. A 32 GB or bigger card is recommended.
- SD Card reader. This is already part of most laptops, but you can purchase a standalone USB adapter if you don't have one. The brand doesn't matter, just pick the cheapest.
- Ethernet cable. Required for installation. After installation, Home Assistant can work with Wi-Fi, but an Ethernet connection is more reliable and highly recommended.
Install Home Assistant Operating System
This guide shows how to install the Home Assistant Operating system onto your Raspberry Pi using Raspberry Pi Imager.
If Raspberry Pi Imager is not supported by your platform, you can use Balena Etcher instead.
Write the image to your SD card
- Download and install the Raspberry Pi Imager on your computer as described under https://www.raspberrypi.com/software/.
- Open the Raspberry Pi Imager and select your Raspberry Pi device.
- Choose the operating system:
- Select Choose OS.
- Select Other specific-purpose OS > Home assistants and home automation > Home Assistant.
- Choose the Home Assistant OS that matches your hardware (RPi 3, RPi 4, or RPi 5).
- Choose the storage:
- Insert the SD card into the computer. Note: the contents of the card will be overwritten.
- Select your SD card.
- Write the installer onto the SD card:
- To start the process, select Next.
- Wait for the Home Assistant OS to be written to the SD card.
- Eject the SD card.
Start up your Raspberry Pi
- Insert the SD card into your Raspberry Pi.
- Plug in an Ethernet cable and make sure the Raspberry Pi is connected to the same network as your computer and is connected to the internet.
- Connect the power supply to start up the device.
Access Home Assistant
Within a few minutes after connecting the Raspberry Pi, you will be able to reach your new Home Assistant.
-
In the browser of your desktop system, enter homeassistant.local:8123.
If you are running an older Windows version or have a stricter network configuration, you might need to access Home Assistant at homeassistant:8123 or `http://X.X.X.X:8123` (replace X.X.X.X with your Raspberry Pi’s IP address). -
The time it takes for this page to become available depends on your hardware. On a Raspberry Pi 4 or 5, this page should be available within a minute.
- If it does not show up after 5 minutes on a Pi 4 or 5, maybe the image was not written properly.
- Try to flash the SD card again, possibly even try a different SD card.
- If this did not help, view the console output on the Raspberry Pi.
- To do this, connect a monitor via HDMI.
- If it does not show up after 5 minutes on a Pi 4 or 5, maybe the image was not written properly.
Congratulations! You finished the Raspberry Pi setup!
{% include installation_survey.html %}
With the Home Assistant Operating System installed and accessible, you can now continue with onboarding.
{% include getting-started/next_step.html step="Onboarding" link="/getting-started/onboarding/" %}
{% include installation/container.md %} {% include installation/core.md %}
Writing the image with Balena Etcher
Use this procedure if Raspberry Pi Imager is not supported by your platform.
-
Insert the SD card into the computer. Note: the contents of the card will be overwritten.
-
Download and start Balena Etcher. You may need to run it with administrator privileges on Windows.
-
Download the image to your computer.
- Copy the correct URL for the Raspberry Pi 3, 4 or 5 (Note: there are 3 different links below!):
{% tabbed_block %} {% for variant in site.installation.types[page.installation_type].variants %}
-
title: {{ variant.name }} content: |
https://github.com/home-assistant/operating-system/releases/download/{{site.data.version_data.hassos[variant.key]}}/haos_{{ variant.key }}-{{site.data.version_data.hassos[variant.key]}}.img.xz
{% endfor %} {% endtabbed_block %}
Select and copy the URL or use the "copy" button that appear when you hover it.
- Paste the URL into your browser to start the download.
- Select Flash from file and select the image you just downloaded.
- Flash from URL does not work on some systems.
6. Select target.
7. Select the SD card you want to use for your installation.
8. Select Flash! to start writing the image.
9. Once Balena Etcher has finished writing the image, you will see a confirmation.
We get commissions for purchases made through links in this post.
{% include common-tasks/enable_i2c.md %}