mirror of
https://github.com/home-assistant/home-assistant.io.git
synced 2025-07-22 08:46:51 +00:00
Split Raspberry Pi getting started (#33777)
This commit is contained in:
Paulus Schoutsen
GitHub
parent
c9bbdb8e7f
commit
33a2f2b502
@ -5,7 +5,7 @@ These below instructions are for an installation of {% term "Home Assistant Cont
|
||||
|
||||
{% important %}
|
||||
|
||||
<bPrerequisites</b>
|
||||
<b>Prerequisites</b>
|
||||
This guide assumes that you already have an operating system setup and a container runtime installed (like Docker).
|
||||
|
||||
If you are using Docker then you need to be on at least version 19.03.9, ideally an even higher version, and `libseccomp` 2.4.2 or newer.
|
||||
|
||||
@ -82,6 +82,7 @@ You can manually define that the previous boot slot is used. This can be useful
|
||||
{% include common-tasks/lost_password.md %}
|
||||
{% include common-tasks/third-party-addons.md %}
|
||||
{% include common-tasks/configuration_check.md %}
|
||||
{% include common-tasks/enable_i2c.md %}
|
||||
|
||||
## Home Assistant versions
|
||||
|
||||
@ -92,3 +93,4 @@ To see which version your system is running, go to {% my info title="**Settings*
|
||||
{% include common-tasks/development_version.md %}
|
||||
|
||||
{% include common-tasks/data_disk.md %}
|
||||
|
||||
|
||||
Binary file not shown.
|
Before Width: | Height: | Size: 220 KiB |
@ -102,7 +102,7 @@ toc: true
|
||||
</div>
|
||||
</div>
|
||||
<div class="buttons">
|
||||
<a href="https://amzn.to/2S0Gcl1" class="button accent"
|
||||
<a href="https://amzn.to/3UH6TcD" class="button accent"
|
||||
>Get Raspberry Pi {% include assets/chevron_right.html %}</a
|
||||
>
|
||||
<a href="/installation/raspberrypi" class="button"
|
||||
@ -389,6 +389,49 @@ toc: true
|
||||
>
|
||||
</p>
|
||||
<p></p>
|
||||
<div class="installations-card">
|
||||
<div class="material-card text">
|
||||
<div class="content-container">
|
||||
<div class="image">
|
||||
<img
|
||||
src="/images/installation/rpi.jpg"
|
||||
/>
|
||||
</div>
|
||||
<div class="content">
|
||||
<h3>Install Home Assistant variants on Raspberry Pi</h3>
|
||||
<p>A low-cost DIY solution to get started with Home Assistant</p>
|
||||
<div class="columns">
|
||||
<div>
|
||||
<b>SKILLS REQUIRED</b>
|
||||
<ul>
|
||||
<li>Assembling a Raspberry Pi setup</li>
|
||||
<li>Flashing a Raspberry Pi</li>
|
||||
<li>Advanced knowledge of Linux</li>
|
||||
<li>Using Linux command line</li>
|
||||
</ul>
|
||||
</div>
|
||||
<div>
|
||||
<b>TOOLS REQUIRED</b>
|
||||
<ul>
|
||||
<li>Raspberry Pi 3, 4 or 5 with power supply</li>
|
||||
<li>MicroSD card</li>
|
||||
<li>Ethernet connection</li>
|
||||
</ul>
|
||||
</div>
|
||||
</div>
|
||||
<div class="buttons">
|
||||
<a href="https://amzn.to/3UH6TcD" class="button accent"
|
||||
>Get Raspberry Pi {% include assets/chevron_right.html %}</a
|
||||
>
|
||||
<a href="/installation/raspberrypi-other" class="button"
|
||||
>View tutorial {% include assets/chevron_right.html %}</a
|
||||
>
|
||||
</div>
|
||||
</div>
|
||||
</div>
|
||||
</div>
|
||||
</div>
|
||||
|
||||
<div class="installations-card">
|
||||
<div class="material-card text">
|
||||
<div class="content-container">
|
||||
|
||||
18
source/installation/raspberrypi-other.markdown
Normal file
18
source/installation/raspberrypi-other.markdown
Normal file
@ -0,0 +1,18 @@
|
||||
---
|
||||
title: "Advanced Raspberry Pi installations"
|
||||
description: "Advanced instructions to install Home Assistant variants on a Raspberry Pi"
|
||||
installation_type: raspberrypi-other
|
||||
---
|
||||
|
||||
{% comment %}
|
||||
Included section for this page is located under source/_includes/installation
|
||||
{% endcomment %}
|
||||
|
||||
{% assign board = "Raspberry Pi" %}
|
||||
{% assign installation_media = "SD card" %}
|
||||
|
||||
While we recommend Home Assistant OS, there are also alternative ways to install Home Assistant. Before you continue, be aware of the limitations and differences compared to Home Assistant OS. You can find more information on the [installation page](/installation/#advanced-installation-methods). Most notably,
|
||||
<a href="/addons">add-ons</a> are only available with the Home Assistant Operating System.
|
||||
|
||||
{% include installation/container.md %}
|
||||
{% include installation/core.md %}
|
||||
@ -10,24 +10,19 @@ Included section for this page is located under source/_includes/installation
|
||||
{% assign board = "Raspberry Pi" %}
|
||||
{% assign installation_media = "SD card" %}
|
||||
|
||||
{% note %}
|
||||
Remember to ensure you're using an [appropriate power supply](https://www.raspberrypi.com/documentation/computers/raspberry-pi.html#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.
|
||||
{% endnote %}
|
||||
|
||||
Before installing Home Assistant, you might want to <a href="/installation#compare-installation-methods">compare installation methods</a>. Most notably,
|
||||
<a href="/addons">add-ons</a> 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.
|
||||
We will need a few things to get started with installing Home Assistant.
|
||||
|
||||
- [Raspberry Pi 5](https://amzn.to/3UH6TcD)
|
||||
- [Raspberry Pi 4](https://amzn.to/2S0Gcl1) (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](https://rpilocator.com/?cat=PI4) to find official distributors with stock.
|
||||
- [Power Supply for Raspberry Pi 4](https://amzn.to/2ReZ2Vq) or [Power Supply for Raspberry Pi 3](https://amzn.to/2R8yG7h)
|
||||
- [Raspberry Pi 5](https://amzn.to/3UH6TcD) or [Raspberry Pi 4](https://amzn.to/2S0Gcl1) with [power supply](https://amzn.to/2ReZ2Vq) (Raspberry Pi 3 Model B is ok to get started, but the Model A does not have enough RAM).
|
||||
- [Micro SD Card](https://amzn.to/2X0Z2di). Ideally get one that is [Application Class 2](https://www.sdcard.org/developers/overview/application/index.html) 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](https://amzn.to/2WWxntY) if you don't have one. The brand doesn't matter, just pick the cheapest.
|
||||
- [Ethernet cable](https://amzn.com/dp/B00N2VISLW). Required for installation. After installation, Home Assistant can work with Wi-Fi, but an Ethernet connection is more reliable and highly recommended.
|
||||
|
||||
{% note %}
|
||||
Remember to ensure you're using an [appropriate power supply](https://www.raspberrypi.com/documentation/computers/raspberry-pi.html#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.
|
||||
{% endnote %}
|
||||
|
||||
## Install Home Assistant Operating System
|
||||
|
||||
This guide shows how to install the Home Assistant Operating system onto your Raspberry Pi using Raspberry Pi Imager.
|
||||
@ -37,7 +32,6 @@ If Raspberry Pi Imager is not supported by your platform, you can use [Balena Et
|
||||
### Write the image to your SD card
|
||||
|
||||
1. Download and install the Raspberry Pi Imager on your computer as described under [https://www.raspberrypi.com/software/](https://www.raspberrypi.com/software/).
|
||||
|
||||
2. Open the Raspberry Pi Imager and select your Raspberry Pi device.
|
||||
|
||||
3. Choose the operating system:
|
||||
@ -86,52 +80,7 @@ With the Home Assistant Operating System installed and accessible, you can now c
|
||||
{% 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.
|
||||
|
||||
1. Insert the SD card into the computer. Note: the contents of the card will be overwritten.
|
||||
2. Download and start <a href="https://www.balena.io/etcher" target="_blank">Balena Etcher</a>. You may need to run it with administrator privileges on Windows.
|
||||
|
||||
3. 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: |
|
||||
|
||||
```text
|
||||
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._
|
||||
|
||||
4. Paste the URL into your browser to start the download.
|
||||
5. 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.
|
||||
|
||||
|
||||
|
||||
<div style="margin-top:50px">
|
||||
<p>
|
||||
<i>We get commissions for purchases made through links in this post.</i></p>
|
||||
</div>
|
||||
|
||||
{% include common-tasks/enable_i2c.md %}
|
||||
|
||||
Loading…
x
Reference in New Issue
Block a user