---
layout: page
title: "Raspberry Pi All-In-One Installer"
date: 2016-05-12 01:39
comments: true
sharing: true
footer: true
---
Easily deploy a complete Home-Assistant server, complete with Websocket MQTT and Z-Wave support out of the box using Fabric!

**Usage:**
*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 ``` on  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.)
 4. Edit ```fabfile.py``` and add the host info for the target host.
 5. Run the "deploy" job to build 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```

 <hr>
**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



**What is [Fabric](http://www.fabfile.org)?**
 The official README says:
*"Fabric is a Python (2.5-2.7) library and command-line tool for streamlining the use of SSH for application deployment or systems administration tasks."*




 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)