jeans/home-assistant.io
jeans/home-assistant.io
1
0
Fork 0
mirror of https://github.com/home-assistant/home-assistant.io.git synced 2025-05-03 09:38:59 +00:00
Code Issues Packages Projects Releases Wiki Activity
home-assistant.io/source/getting-started/installation-raspberry-pi-all-in-one.markdown
Jonathan Baginski a718069424 Provided PR feedback updates
2016-05-12 19:04:53 -04:00

2.1 KiB
Raw Blame History

layout, title, date, comments, sharing, footer
layout title date comments sharing footer
page Raspberry Pi All-In-One Installer 2016-05-12 01:39 true true true

Easily deploy a complete Home Assistant server, with Websocket MQTT and Z-Wave support out of the box using Fabric!

Steps to run: Start with a fresh Raspbian Jessie/Jessie-Lite or Debian 8 install

  1. install fabric locally: pip3 install fabric3
  2. Ensure you can SSH into Target Host
  3. Clone the repo : git clone https://github.com/jbags81/fabric-home-assistant.git (or simply download the zip) to your local host. The repo contains a pre-configured default mosquitto.conf file. The only addition is an added listener for websockets listening on 9001. It also contains preconfigured systemd service profiles. For the fabric script to run successfully, it has to be ran from the root of the cloned repo or zip archive.
  4. Edit fabfile.py and add the host info for the target host.
  5. Run the "deploy" job to build your new Home Assistant server: fab deploy
  6. Reboot

Everything will start at boot, and Home Assistant is accessible now from http://your_server_ip:8123

The Home Assistant configs are located in: /home/hass The virtualenv path, along with where all python packages will install is located at: /srv/hass/hass_venv

The All-In-One Fabric script will do the following automatically:

  • Create all needed directories
  • Create needed service accounts
  • Install OS and Python dependencies
  • Setup a virtualenv to run Home Assistant and components inside.
  • Run as a service account
  • Install Home Assistant in a virtualenv
  • Build and install Mosquitto from source with websocket support
  • Build and Install Python-openzwave in the Home Assistant virtualenv
  • Add both Home Assistant and Mosquitto to systemd services to start at boot

Fabric allows any of the underlying functions to be ran individually as well. Run fab -l to see a list of all callable jobs.

Tested with:

  • Raspbian Jessie
  • Raspbian Jessie-Lite
  • Debian 8 (Replace username "pi" in fabfile.py with debian user)