diff --git a/sass/custom/_paulus.scss b/sass/custom/_paulus.scss index 2b48d400c9f..5665d407074 100644 --- a/sass/custom/_paulus.scss +++ b/sass/custom/_paulus.scss @@ -19,8 +19,6 @@ h6:hover a.title-link { } } -f0c1 - .ha-title { white-space: nowrap; @@ -124,3 +122,43 @@ p.note { } } + +.install-instructions-container { + #normal-install, #raspberry-install, #docker-install, .install-instructions { + display: none; + } + + label.menu-selector { + display: inline-block; + text-align: center; + padding: 20px; + white-space: nowrap; + border-bottom: 5px solid $grayLight; + transition: border-bottom-color .5s; + } + + label.menu-selector + label.menu-selector { + margin-left: 10px; + } + + #normal-install:checked ~ .menu-selector.normal, + #raspberry-install:checked ~ .menu-selector.raspberry, + #docker-install:checked ~ .menu-selector.docker + { + border-bottom-color: $blue; + } + + #normal-install:checked ~ .install-instructions.normal, + #raspberry-install:checked ~ .install-instructions.raspberry, + #docker-install:checked ~ .install-instructions.docker + { + display: block; + } + + .install-instructions { + margin-top: 30px; + } +} + + + diff --git a/source/getting-started/index.markdown b/source/getting-started/index.markdown index 9491af7b125..623bc1eb1a9 100644 --- a/source/getting-started/index.markdown +++ b/source/getting-started/index.markdown @@ -9,23 +9,33 @@ sharing: true footer: true --- -Installing and running Home Assistant is easy. Make sure you have [Python 3.4](https://www.python.org/downloads/) and [git](http://git-scm.com/downloads) installed and execute the following code in a console: +
+ + + + + + +
+Installing and running Home Assistant on your local machine is easy. Make sure you have Python 3.4 and git installed and execute the following code in a console: + +

```bash git clone --recursive https://github.com/balloob/home-assistant.git cd home-assistant python3 -m pip install -r requirements.txt python3 -m homeassistant --open-ui ``` - -Running these commands will: - -1. Download Home Assistant -2. Navigate to downloaded files -3. Install the dependencies -4. Launch Home Assistant and serve web interface on [http://localhost:8123](http://localhost:8123) - -If you run into any issues, please see the [troubleshooting page]({{site_root}}/getting-started/troubleshooting.html). +

+

Running these commands will:

+
    +
  1. Download Home Assistant
    2. +
  2. Navigate to downloaded files
    3. +
  3. Install the dependencies
    4. +
  4. Launch Home Assistant and serve web interface on http://localhost:8123
    5. +
+

If you run into any issues, please see the troubleshooting page.

You can run Home Assistant in demo mode by appending --demo-mode to line 4. @@ -35,11 +45,104 @@ If you run into any issues, please see the [troubleshooting page]({{site_root}}/ If you want to update to the latest version in the future, run: scripts/update.

-If you're using Docker, you can use +
+ +
+

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/homeassistant/config:/config -v /etc/localtime:/etc/localtime:ro --net=host balloob/home-assistant +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 its 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) +

+
+ +
+ +

Home Assistant uses Python 3.4. This makes installation on a Raspberry Pi a bit more difficult as it is not available in the package repository. Please follow the following instructions to get it up and running.

+ +

Step 1. Install pyenv

+ +```bash +curl -L https://raw.githubusercontent.com/yyuu/pyenv-installer/master/bin/pyenv-installer | bash +``` + +

After the installation is done, run:

+ +```bash +nano ~/.bashrc +``` + +

Then add these lines to the end of the file and save:

+``` +export PATH="$HOME/.pyenv/bin:$PATH" +eval "$(pyenv init -)" +eval "$(pyenv virtualenv-init -)" +``` + +

Step 2. Install requirements

+ +```bash +sudo apt-get install python3-dev +sudo apt-get install libsqlite3-dev libreadline-dev +``` + +

Log out and then back in so your bashrc is reloaded.

+ +

+NOTE: the rest of the commands are not being run as sudo and will install python etc under you user's home directory. +

+ +

Step 3. Install python 3.4.2 (this will take a few hours)

+ +```bash +pyenv install 3.4.2 +``` + +

Step 4. Create Python Virtual Environment

+```bash +pyenv virtualenv 3.4.2 homeassistant +``` + +

Step 5. Clone the source

+```bash +git clone --recursive https://github.com/balloob/home-assistant.git +``` + +

Step 6. Set the virtual environment

+```bash +cd home-assistant +pyenv local homeassistant +``` + +

Step 6. Finish the install

+```bash +python3 -m pip install -r requirements.txt +``` + +

Step 7. Start it up

+```bash +python3 -m homeassistant +``` + +

It will be up and running on port 8123

+ +

+ You can run Home Assistant in demo mode by appending --demo-mode to line 4. +

+ +

+ If you want to update to the latest version in the future, run: scripts/update. +

+ +
+ +
+ ## {% linkable_title Configuring Home Assistant %} The configuration for Home Assistant lives by default in the `config` folder. The file `home-assistant.conf` is the main file that contains which components will be loaded and what their configuration is. An example configuration file is located at [`config/home-assistant.conf.example`](https://github.com/balloob/home-assistant/blob/master/config/home-assistant.conf.example). diff --git a/source/getting-started/troubleshooting.markdown b/source/getting-started/troubleshooting.markdown index e3bf91621f4..f48cc0de35e 100644 --- a/source/getting-started/troubleshooting.markdown +++ b/source/getting-started/troubleshooting.markdown @@ -11,8 +11,8 @@ footer: true It can happen that you run into trouble while installing Home Assistant. This page is here to help you figure out the most common problems. -Check if Python3 is installed by running `python3 --version`. If it is not installed, install it here. +Check if Python 3.4 is installed by running `python3 --version`. If it is not installed, [download it here](https://www.python.org/getit/). -Pip should come bundled with the latest Python3 but is ommitted by some distributions. If you are unable to run `python3 -m pip --version` you can install pip by [downloading the installer](https://bootstrap.pypa.io/get-pip.py) and run it with Python3: `python3 get-pip.py`. +Pip should come bundled with the latest Python 3 but is ommitted by some distributions. If you are unable to run `python3 -m pip --version` you can install pip by [downloading the installer](https://bootstrap.pypa.io/get-pip.py) and run it with Python 3: `python3 get-pip.py`. Check if Git is installed by running `git --version`. If you are unable to run this command you can install it by following [these instructions](http://git-scm.com/downloads).