Installing and running Home Assistant on your local machine is easy. Make sure you have [Python 3.4 or higher](https://www.python.org/downloads/) installed and execute the following code in a console:

It's highly recommended to use a [virtual environment](https://docs.python.org/3.4/library/venv.html) to keep things separated. A virtual environment can be created by exceuting the following command: `python3 -m venv /path/where/you/home-assistant/`. Then change to the created directory and go the next step.

```bash $ pip3 install homeassistant $ hass --open-ui ``` Running these commands will: - Install Home Assistant - Launch Home Assistant and serve the web interface on [http://localhost:8123](http://localhost:8123) If you prefer to watch a video tutorial, [tktino](https://github.com/tktino) has made some great ones. - [Windows 10](https://www.youtube.com/watch?v=X27eVvuqwnY) - [Mac OS X](https://www.youtube.com/watch?v=hej6ipN86ls) - [Ubuntu 14.04](https://www.youtube.com/watch?v=SXaAG1lGNH0) ### {% linkable_title Updating %} To update Home Assistant to the latest release when available, run: `pip3 install --upgrade homeassistant` You have to restart Home Assistant (`hass` itself or with the help of the autostarting daemon if you use any) for the changes to take effect.

Installation with Docker is straightforward. Adjust the following command so that `/path/to/your/config/` points at the folder where you want to store your config and run it: ```bash $ docker run -d --name="home-assistant" -v /path/to/your/config:/config -v /etc/localtime:/etc/localtime:ro --net=host balloob/home-assistant ``` This will launch Home Assistant and serve the web interface from port 8123 on your Docker host.

When using boot2docker on OS X you are unable to map the local time to your Docker container. Replace `-v /etc/localtime:/etc/localtime:ro` with `-e "TZ=America/Los_Angeles"` (replacing America/Los_Angeles with [your timezone](http://en.wikipedia.org/wiki/List_of_tz_database_time_zones))

Home Assistant requires the Raspberry Pi to run [Raspbian Jessie](https://www.raspberrypi.org/downloads/raspbian/). This version was released on September 24, 2015 and comes by default with Python 3.4 which is required for Home Assistant. Execute the following code in a console: ```bash $ sudo pip3 install homeassistant $ hass ``` Running these commands will: - Install Home Assistant - Launch Home Assistant and serve the web interface on [http://localhost:8123](http://localhost:8123) There is also a [video tutorial](https://www.youtube.com/watch?v=GjzOXkPb7XE) created by [brusc](https://github.com/brusc). ### {% linkable_title Updating %} To update Home Assistant to the latest release when available, run: `pip3 install --upgrade homeassistant` You have to restart Home Assistant (`hass` itself or with the help of the autostarting daemon if you use any) for the changes to take effect.

The following configuration has been tested on Synology 413j running DSM 6.0-7321 Update 1. Running these commands will: - Install Home Assistant - Enable Home Assistant to be launched on [http://localhost:8123](http://localhost:8123) Using the Synology webadmin: - Install python3 using the Synology package centre - Create homeassistant user and add to the "users" group SSH onto your synology & login as admin or root Check the path to python3 (assumed to be /volume1/@appstore/py3k/usr/local/bin) ```bash $ cd /volume1/@appstore/py3k/usr/local/bin ``` Install PIP (Python's package management system) ```bash $ python -m ensurepip ``` Use PIP to install Homeassistant package ```bash $ pip3 install homeassistant ``` Create homeassistant config directory & switch to it ```bash $ mkdir /volume1/homeassistant $ cd /volume1/homeassistant ``` Create hass-daemon file using the following code (edit the variables in uppercase if necessary) ```bash #!/bin/sh # Package PACKAGE="homeassistant" DNAME="Home Assistant" # Others USER="homeassistant" PYTHON_DIR="/volume1/@appstore/py3k/usr/local/bin" PYTHON="$PYTHON_DIR/python3" HASS="$PYTHON_DIR/hass" INSTALL_DIR="/volume1/homeassistant" PID_FILE="$INSTALL_DIR/home-assistant.pid" FLAGS="-v --config $INSTALL_DIR --pid-file $PID_FILE --daemon" REDIRECT="> $INSTALL_DIR/home-assistant.log 2>&1" start_daemon () { su ${USER} -s /bin/sh -c "$PYTHON $HASS $FLAGS $REDIRECT;" } stop_daemon () { kill `cat ${PID_FILE}` wait_for_status 1 20 || kill -9 `cat ${PID_FILE}` rm -f ${PID_FILE} } daemon_status () { if [ -f ${PID_FILE} ] && kill -0 `cat ${PID_FILE}` > /dev/null 2>&1; then return fi rm -f ${PID_FILE} return 1 } wait_for_status () { counter=$2 while [ ${counter} -gt 0 ]; do daemon_status [ $? -eq $1 ] && return let counter=counter-1 sleep 1 done return 1 } case $1 in start) if daemon_status; then echo ${DNAME} is already running exit 0 else echo Starting ${DNAME} ... start_daemon exit $? fi ;; stop) if daemon_status; then echo Stopping ${DNAME} ... stop_daemon exit $? else echo ${DNAME} is not running exit 0 fi ;; restart) if daemon_status; then echo Stopping ${DNAME} ... stop_daemon echo Starting ${DNAME} ... start_daemon exit $? else echo ${DNAME} is not running echo Starting ${DNAME} ... start_daemon exit $? fi ;; status) if daemon_status; then echo ${DNAME} is running exit 0 else echo ${DNAME} is not running exit 1 fi ;; log) echo ${LOG_FILE} exit 0 ;; *) exit 1 ;; esac ``` Create links to python folders to make things easier in the future: ```bash $ ln -s /volume1/@appstore/py3k/usr/local/bin python3 $ ln -s /volume1/@appstore/py3k/usr/local/lib/python3.5/site-packages/homeassistant ``` Set the owner and permissions on your config folder ```bash $ chown -R homeassistant:users /volume1/homeassistant $ chmod -R 664 /volume1/homeassistant ``` Make the daemon file executable: ```bash $ chmod 777 /volume1/homeassistant/hass-daemon ``` Copy your configuration.yaml file into the config folder That's it... you're all set to go Here are some useful commands: - Start Home Assistant: ```bash $ sh hass-daemon start ``` - Stop Home Assistant: ```bash $ sh hass-daemon stop ``` - Restart Home Assistant: ```bash $ sh hass-daemon restart ``` - Upgrade Home Assistant:: ```bash $ python3 -m pip install --upgrade homeassistant ```