481320128f
* Split MQTT documentation * Add more details * Move content to /docs * Enable sidebar * Move content to /docs * Enable sidebar * Move content * Update links * Remove wizard stuff * Enable sidebar * Minor changes * Move MQTT parts to /docs * update links * Update links and sync content * Fix link * Enable sidebar * Remove navigation * Remove navigation and other minor updates * Update links * Add overview page * Make title linkable * Update * Plit content * Update links * Rearrange content * New getting-started section * Add icons for docs * Update for new structure * Update for new structure * Add docs navigation * Add docs overview page * Remove ecosystem navigation * Add docs and remove other collections * Move ecosystem to docs * Remove duplicate files * Re-add ecosystem overview * Move to ecosystem * Fix permission * Update navigation * Remove collection * Move overview to right folder * Move mqtt to upper level * Move notebook to ecosystem * Remove un-used files * Add one more rectangle for iOS * Move two parts back from docs and rename Run step * Remove colon * update getting-started section * Add redirect * Update * Update navigation
2.4 KiB
| layout | title | description | date | sidebar | comments | sharing | footer | redirect_from |
|---|---|---|---|---|---|---|---|---|
| page | Manual installation on a Raspberry Pi | Instructions to install Home Assistant on a Raspberry Pi runnning Raspbian Lite. | 2016-09-05 16:00 | true | false | true | true | /getting-started/installation-raspberry-pi/ |
This installation of Home Assistant requires the Raspberry Pi to run Raspbian Lite. The installation will be installed in a Virtual Environment with minimal overhead. Instructions assume this is a new installation of Raspbian Lite.
Connect to the Raspberry Pi over SSH. Default password is raspberry.
You will need to enable SSH access. The Raspberry Pi website has instructions here.
$ ssh pi@ipadress
Changing the default password is encouraged.
$ passwd
Update the system.
$ sudo apt-get update
$ sudo apt-get upgrade -y
Install the dependencies.
$ sudo apt-get install python3 python3-venv python3-pip
Add an account for Home Assistant called homeassistant.
Since this account is only for running Home Assistant the extra arguments of -rm is added to create a system account and create a home directory.
$ sudo useradd -rm homeassistant
Next we will create a directory for the installation of Home Assistant and change the owner to the homeassistant account.
$ cd /srv
$ sudo mkdir homeassistant
$ sudo chown homeassistant:homeassistant homeassistant
Next up is to create and change to a virtual environment for Home Assistant. This will be done as the homeassistant account.
$ sudo su -s /bin/bash homeassistant
$ cd /srv/homeassistant
$ python3 -m venv .
$ source bin/activate
Once you have activated the virtual environment you will notice the prompt change and then you can install Home Assistant.
(homeassistant) homeassistant@raspberrypi:/srv/homeassistant $ pip3 install homeassistant
Start Home Assistant for the first time. This will complete the installation, create the .homeasssistant configuration directory in the /home/homeassistant directory and install any basic dependencies.
(homeassistant) $ hass
You can now reach your installation on your Raspberry Pi over the web interface on http://ipaddress:8123.