3.5 KiB
| title | description |
|---|---|
| Installation of Home Assistant | Instructions on how to install Home Assistant to launch on start. |
Beginners should check our Getting started guide first.
Home Assistant provides multiple ways to be installed. The first start may take up to 20 minutes because the required packages will be downloaded and installed. The web interface will be served on http://ip.add.re.ss:8123/. Replace ip.add.re.ss with the IP of the computer you installed it on.
Please remember to secure your installation once you've finished with the installation process.
Hardware
Below is a list of minimum requirements
| Type | Minimum |
|---|---|
| Storage | 32 GB |
| Memory | 1 GB |
| Network | 100 Mb/s wired |
| Power (if Pi) | At least 2.5A |
Performance expectations
This is a list of popular platforms and what to expect from them.
| Platform | Notes |
|---|---|
| Raspberry Pi Zero/Pi 2 | Only use these for testing |
| Raspberry Pi 3/3+/4 | This is a good starting point, and depending on the amount of devices you integrate this can be enough - use an A2 class SD card if possible. |
| NUC i3 | This is if you need a little more power over a Pi |
| NUC i5 | This will allow you to run multiple services without any issues, perfect for a homelab |
| NUC i7/i9 | Pure power, you should not have any performance issues |
Recommended
These install options are fully supported by Home Assistant's documentation. For example, if an integration requires that you install something to make it work on one of these methods then the integration page will document the steps required.
The only installation methods that allow you to use Home Assistant Add-ons is using the Home Assistant image. All other methods only install the base Home Assistant packages, however the software from the add-ons may still usually be installed manually like any other program.
| Method | You have | Recommended for |
|---|---|---|
| Home Assistant OS | A supported platform | Anybody |
| Home Assistant Container | Docker | Anybody already running Docker |
Alternative installs
If you use these install methods, we assume that you know how to manage and administer the operating system you're using. Due to the range of platforms on which these install methods can be used, integration documentation may only tell you what you have to install, not how to install it.
| Method | You have | Recommended for |
|---|---|---|
| Home Assistant Core | Any Linux, Python 3.8 or later | Those familiar with their operating system |
| Home Assistant Supervised | Requirements | Those very familiar with their operating system |
| venv (as your user) |
Any Python 3.8 or later | Developers |
Community provided guides
Additional installation guides can be found on our Community Forum.
These Community Guides are provided as-is. Some of these install methods are more limited than the methods above. Some integrations may not work due to limitations of the platform.