038dee0011
* Clarify install of docker
Updated description of installation to avoid possible confusion regarding docker as a dependency.
* Details on tested environment
Underlining Ubuntu as the tested environment for the given instructions.
* Removed redundant docker install step
Removed step from hass.io installation instructions wherein installing docker. Installation of Docker-CE is already documented.
* ✏️ Tweaks
6.0 KiB
layout, title, description, date, sidebar, comments, sharing, footer
| layout | title | description | date | sidebar | comments | sharing | footer |
|---|---|---|---|---|---|---|---|
| page | Installing Hass.io | Instructions on how to install Hass.io. | 2017-04-30 13:28 | true | false | true | true |
The following will take you through the steps required to install Hass.io.
-
Download the appropriate install option:
-
As an image for your device:
-
As a virtual appliance:
- VMDK
- VHDX (beta)
- VDI (beta)
- OVA (not available at this time!)
-
-
Install Hass.io:
- Flash the downloaded image to an SD card using Etcher. We recommend at least a 32 GB SD card to avoid running out of space.
- Load the appliance image into your virtual machine software.
-
Optional - set up the WiFi or static IP: On a USB stick, create the
network/my-networkfile and follow the HassOS howto. -
For image-based installs insert the SD card (and optional USB stick) into the device.
-
Turn on your device or virtual appliance. On first boot, it downloads the latest version of Home Assistant which takes around 20 minutes (slower/faster depending on the platform and your Internet connection).
-
You will be able to reach your installation at http://hassio.local:8123 (if your router supports mDNS, otherwise see below).
-
Enable either the Samba add-on or the SSH add-on to manage your configuration in
/config/(From the UI choose Hass.io which is located in the sidebar).
If your router doesn't support mDNS, then you'll have to use the IP address of your Pi instead of `hassio.local`. For example, `http://192.168.0.9:8123`. You should be able to find the IP address of your Pi from the admin interface of your router.
If you are using a Raspberry Pi please remember to ensure you're using an [appropriate power supply][pi-power] with your Pi. Mobile chargers may not be suitable since some were only designed to provide just enough power to the device it was designed for by the manufacturer. **Do not** try to power the Pi from the USB port on a TV, computer, or similar.
Now you can configure your install.
{% linkable_title Migrating from a non-Hass.io install %}
If you copy over your existing Home Assistant configuration, make sure to enable the Hass.io panel by adding either discovery: or hassio: to your configuration.
{% linkable_title Alternative: install on generic Linux server %}
For advanced users, it is also possible to try Hass.io on your Linux server or inside a virtual machine. Examples given here are tested on Ubuntu, but the instructions should work as a guideline for installing on other Linux distrubutions.
This is the list of packages you need to have available on your system that will run Hass.io if you are using Debian/Ubuntu:
- apparmor-utils
- apt-transport-https
- avahi-daemon
- ca-certificates
- curl
- dbus
- jq
- network-manager
- socat
- software-properties-common
You also need to have Docker-CE installed. There is well-documented procedures for installing Docker on Ubuntu at Docker.com.
Some distributions, like Ubuntu, have a `docker.io` package available. Using that packages will cause issues! Be sure to install the official Docker-CE from the above listed URL.
To perform the Hass.io installation, run the following commands:
sudo -i
add-apt-repository universe
apt-get update
apt-get install -y apparmor-utils apt-transport-https avahi-daemon ca-certificates curl dbus jq network-manager socat software-properties-common
curl -sL "https://raw.githubusercontent.com/home-assistant/hassio-build/master/install/hassio_install" | bash -s
When you use this installation method, the core SSH add-on may not function correctly. If that happens, use the community SSH add-on. Some of the documentation might not work for your installation either.
A detailed guide about running Hass.io as a virtual machine is available in the blog.