diff --git a/sass/custom/_paulus.scss b/sass/custom/_paulus.scss index 2aadb83156f..e7bf78e4738 100644 --- a/sass/custom/_paulus.scss +++ b/sass/custom/_paulus.scss @@ -180,17 +180,17 @@ p.note { } -.post-instructions-container { - #generic-post, #fedora-post, #debian-post, .post-instructions { +.install-instructions-container { + #normal-install, #raspberry-install, #docker-install, .install-instructions { display: none; } label.menu-selector { display: inline-block; text-align: center; - padding: 10px; + padding: 20px; white-space: nowrap; - border-bottom: 2px solid $grayLight; + border-bottom: 5px solid $grayLight; transition: border-bottom-color .5s; } @@ -198,65 +198,27 @@ p.note { margin-left: 10px; } - #generic-post:checked ~ .menu-selector.generic-post, - #fedora-post:checked ~ .menu-selector.fedora-post, - #debian-post:checked ~ .menu-selector.debian-post + #normal-install:checked ~ .menu-selector.normal, + #raspberry-install:checked ~ .menu-selector.raspberry, + #docker-install:checked ~ .menu-selector.docker { border-bottom-color: $blue; } - #generic-post:checked ~ .post-instructions.generic-post, - #fedora-post:checked ~ .post-instructions.fedora-post, - #debian-post:checked ~ .post-instructions.debian-post + #normal-install:checked ~ .install-instructions.normal, + #raspberry-install:checked ~ .install-instructions.raspberry, + #docker-install:checked ~ .install-instructions.docker { display: block; } - .post-instructions { - margin-top: 20px; - } - -} - -.install-channels-container { - #prod-channel, #beta-channel, #dev-channel, .install-channels { - display: none; - } - - label.menu-selector { - display: inline-block; - text-align: center; - padding: 10px; - white-space: nowrap; - border-bottom: 2px solid $grayLight; - transition: border-bottom-color .5s; - } - - label.menu-selector + label.menu-selector { - margin-left: 10px; - } - - #prod-channel:checked ~ .menu-selector.prodchan, - #beta-channel:checked ~ .menu-selector.betachan, - #dev-channel:checked ~ .menu-selector.devchan - { - border-bottom-color: $blue; - } - - #prod-channel:checked ~ .install-channels.prodchan, - #beta-channel:checked ~ .install-channels.betachan, - #dev-channel:checked ~ .install-channels.devchan - { - display: block; - } - - .install-channels { - margin-top: 20px; + .install-instructions { + margin-top: 30px; } } .advanced-installs-container { - #docker-install, #debian-install, #fedora-install, .advanced-installs { + #debian-install, #fedora-install, .advanced-installs { display: none; } @@ -273,14 +235,12 @@ p.note { margin-left: 10px; } - #docker-install:checked ~ .menu-selector.docker, #debian-install:checked ~ .menu-selector.debian, #fedora-install:checked ~ .menu-selector.fedora { border-bottom-color: $blue; } - #docker-install:checked ~ .advanced-installs.docker, #debian-install:checked ~ .advanced-installs.debian, #fedora-install:checked ~ .advanced-installs.fedora { diff --git a/source/getting-started/advanced.markdown b/source/getting-started/advanced.markdown index c0ac7592522..24c45d73377 100644 --- a/source/getting-started/advanced.markdown +++ b/source/getting-started/advanced.markdown @@ -12,28 +12,11 @@ footer: true Here are some general tutorials on how to setup some of the more advanced deployments that are frequently requested.
- - + - -
-**Docker Deployment** -

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 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) -

-
-
**Debian Deamon**

Debian based systems, including Ubuntu and Raspbian for the Raspberry Pi use an application called Init to manage daemon services. Init will launch init scripts that are located in the directory /etc/init.d/. A sample init script for Debian based systems is maintained in this project.

diff --git a/source/getting-started/index.markdown b/source/getting-started/index.markdown index 6be4f213ae6..f2f2cbfdf62 100644 --- a/source/getting-started/index.markdown +++ b/source/getting-started/index.markdown @@ -9,79 +9,67 @@ sharing: true footer: true --- -

Requirements

-

Home Assistant requires at least Python 3.4. For the Raspberry Pi, install instructions can be found here. Other systems generally have this bundled or contain easy to install packages.

- -

To ensure Python 3.4 is installed, type the following command into the console:

- -```bash -python3 --version -``` +
+ + + + + +

Installation

-
- - - - - - -
-

Installing from the production channel is fast, easy, and will provide you with access to the newest stable builds. This is recommended for most users. To install, 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 installed and execute the following code in a console: + +

```bash pip3 install homeassistant hass --open-ui ``` -

Running these commands will: +

+

Running these commands will:

  1. Install Home Assistant
    2. -
  2. Launch Home Assistant and serve web interface on http://localhost:8123
    3. -

-

When new stable versions are released, you can upgrade to newest version by typing the following into a console:

-```bash -pip3 install --upgrade homeassistant -``` -
+
  • Launch Home Assistant and serve web interface on http://localhost:8123
    • + +
    + + +
    +

    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:

    -
    -

    The beta channel will provide you with newer features sooner but at the risk of reduced stability. The brave and curious are welcomed here. To install, execute the following code in a console:

    ```bash -pip3 install --pre homeassistant +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 which is not shipped with the current Raspbian distibution for the Raspberry Pi. Before installing Home Assistant, you will have to target="_blank"install Python 3.4. + +Once that is complete, installing and running Home Assistant on your local machine is easy. Make sure you have Python 3.4 installed and execute the following code in a console: + +

    +```bash +pip3 install homeassistant hass --open-ui ``` -

    Running these commands will: +

    +

    Running these commands will:

    1. Install Home Assistant
      2. -
    2. Launch Home Assistant and serve web interface on http://localhost:8123
      3. -

    -

    When new a new release candidate, alpha, or beta version is released, you can upgrade to newest version by typing the following into a console:

    -```bash -pip3 install --pre --upgrade homeassistant -``` -
    - -
    -

    The development channel provides builds that are on the bleeding edge. This builds have not been fully tested or used. This is best for potential contributors and tinkerers. Subscribing to this channel is not for the faint of heart and requires significant knowledge of Git and Python.

    -```bash -# Clone repo from git, you may want to use your own fork -git clone --recursive https://github.com/balloob/home-assistant.git -cd home-assistant -# You may want to switch to a virtual environment here -# Install Home Assistant in development mode -python3 setup.py develop -# Optionally pre-emptively install all possible dependencies -pip3 install -r requirements_all.txt -``` -

    To keep up-to-date with the development channel, you will have to fetch and merge from the dev branch in the head repository. Be careful when doing this.

    -```bash -git fetch balloob -git merge remotes/balloob/dev -``` -
    - -
    +
  • Launch Home Assistant and serve web interface on http://localhost:8123
    • + +

    Troubleshooting

    @@ -96,10 +84,19 @@ git merge remotes/balloob/dev

    +

    Staying Up to Date

    +

    In order to update Home Assistant to the latest stable release, simply type the following into a console:

    +```bash +pip install --upgrade homeassistant +``` +

    If you would like to stay up to date with the newest unstable builds (alphas, betas, and release candidates), use this command:

    +```bash +pip install --upgrade --pre homeassistant +```

    What's Next

    If you want to see what Home Assistant can do, you can start the demo mode by running hass --demo-mode. Home Assistant has a few other command line flags that can be displayed by running hass --help.

    -

    From here you may now start configuring Home Assistant to your liking. For more advanced users, the advanced configuration page contains brief tutorials on creating more advanced installations such as installing daemons and using Docker.

    +

    From here you may now start configuring Home Assistant to your liking. For more advanced users, the advanced configuration page contains brief tutorials on creating more advanced installations.

    ###[Next step: configuring Home Assistant »](/getting-started/configuration.html)