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-07-24 09:46:59 +00:00
Code Issues Packages Projects Releases Wiki Activity

Updated Advanced Install page to focus on daemon managers.

Browse Source 
The advanced install page was reworded to be organized by daemon
manager rather than Linux distribution.

Some wording changes were made on the Getting Started page.
This commit is contained in:
Ryan Kraus 2015-09-05 05:40:45 -04:00
parent 9d3ea63632
commit 7ba2a55232
3 changed files with 44 additions and 31 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

17
sass/custom/_paulus.scss
View File

@ -218,16 +218,17 @@ p.note {
}
.advanced-installs-container {
#debian-install, #fedora-install, .advanced-installs {
#upstart-install, #systemd-install, .advanced-installs {
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;
}
@ -235,19 +236,19 @@ p.note {
margin-left: 10px;
}
#debian-install:checked ~ .menu-selector.debian,
#fedora-install:checked ~ .menu-selector.fedora
#upstart-install:checked ~ .menu-selector.upstart,
#systemd-install:checked ~ .menu-selector.systemd
{
border-bottom-color: $blue;
}
#debian-install:checked ~ .advanced-installs.debian,
#fedora-install:checked ~ .advanced-installs.fedora
#upstart-install:checked ~ .advanced-installs.upstart,
#systemd-install:checked ~ .advanced-installs.systemd
{
display: block;
}
.advanced-installs {
margin-top: 20px;
margin-top: 30px;
}
}

54
source/getting-started/advanced.markdown
View File

@ -12,34 +12,46 @@ footer: true
Here are some general tutorials on how to setup some of the more advanced deployments that are frequently requested.
<div class='advanced-installs-container'>
<input name='advanced-installs' type='radio' id='debian-install' checked>
<input name='advanced-installs' type='radio' id='fedora-install'>
<label class='menu-selector debian' for='debian-install'>Debian (Ubuntu, Raspbian) Daemon</label>
<label class='menu-selector fedora' for='fedora-install'>Fedora (RHEL, CentOS) Daemon</label>
<input name='advanced-installs' type='radio' id='upstart-install' checked>
<input name='advanced-installs' type='radio' id='systemd-install'>
<label class='menu-selector upstart' for='upstart-install'>Upstart Daemon</label>
<label class='menu-selector systemd' for='systemd-install'>Systemd Daemon</label>
<div class='advanced-installs debian'>
**Debian Deamon**
<p>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 <code>/etc/init.d/</code>. A sample init script for Debian based systems is <a href="https://raw.githubusercontent.com/balloob/home-assistant/dev/scripts/hass-daemon">maintained in this project</a>.</p>
<p>To install this script, download it, tweak it to you liking, and install it by following the directions in the header. This script will setup Home Assistant to run when the system boots. To start/stop Home Assistant manually, issue the following commands:
<div class='advanced-installs upstart'>
Many linux distributions use the Upstart system (or similar) for managing daemons. Typically, systems based on Debian 7 or previous use Upstart. This includes Ubuntu releases before 15.04 and all current Raspian releases. If you are unsure if your system is using Upstart, you may check with the following command:
```bash
ps -p 1 -o comm=
```
If the preceding command returns the string `init`, you are likely using Upstart.
Upstart will launch init scripts that are located in the directory <code>/etc/init.d/</code>. A sample init script for systems using Upstart is <a href="https://raw.githubusercontent.com/balloob/home-assistant/dev/scripts/hass-daemon">maintained by this project</a>.
To install this script, download it, tweak it to you liking, and install it by following the directions in the header. This script will setup Home Assistant to run when the system boots. To start/stop Home Assistant manually, issue the following commands:
```bash
sudo service hass-daemon start
sudo service hass-daemon stop
```
</p>
<p>When running Home Assistant with this script, the configuration directory will be located at <code>/var/opt/homeassistant</code>. This directory will contain a verbose log rather than simply an error log.</p>
When running Home Assistant with this script, the configuration directory will be located at <code>/var/opt/homeassistant</code>. This directory will contain a verbose log rather than simply an error log.
<p>When running daemons, it is good practice to have the daemon run under its own user name rather than the default user's name. Instructions for setting this up are outside the scope of this document.</p>
</div> <!-- DEBIAN -->
When running daemons, it is good practice to have the daemon run under its own user name rather than the default user's name. Instructions for setting this up are outside the scope of this document.
</div> <!-- UPSTART -->
<div class='advanced-installs fedora'>
**Fedora Daemon**
<p>If you want that Home Assistant is lauched automatically, an extra step is needed to setup <code>systemd</code>. You need a service file to control Home Assistant with <code>systemd</code>. <!-- The <code>WorkingDirectory</code> and the <code>PYTHONPATH</code> must point to your clone git repository. --></p>
<!-- WorkingDirectory=/home/fab/home-assistant/
Environment="PYTHONPATH=/home/fab/home-assistant/" -->
<div class='advanced-installs systemd'>
Newer linux distributions are trending towards using systemd for managing daemons. Typically, systems based on Fedora or Debian 8 or later use systemd. This includes Ubuntu releases including and after 15.04, CentOS, and Red Hat. If you are unsure if your system is using systemd, you may check with the following command:
```bash
ps -p 1 -o comm=
```
If the preceding command returns the string `systemd`, you are likely using systemd.
If you want Home Assistant to be launched automatically, an extra step is needed to setup systemd. You need a service file to control Home Assistant with systemd.
```bash
su -c 'cat <<EOF >> /lib/systemd/system/home-assistant.service
@ -56,7 +68,7 @@ WantedBy=multi-user.target
EOF'
```
<p>You need to reload <code>systemd</code> to make the daemon aware of the new configuration. Enable and launch Home Assistant after that.</p>
You need to reload systemd to make the daemon aware of the new configuration. Enable and launch Home Assistant after that.
```bash
sudo systemctl --system daemon-reload
@ -64,7 +76,7 @@ sudo systemctl enable home-assistant
sudo systemctl start home-assistant
```
<p>If everything went well, <code>sudo systemctl start home-assistant</code> should give you a positive feedback.</p>
If everything went well, <code>sudo systemctl start home-assistant</code> should give you a positive feedback.
```bash
$ sudo systemctl status home-assistant -l
@ -77,11 +89,11 @@ $ sudo systemctl status home-assistant -l
[...]
```
<p>To get Home Assistant's logging output, simple use <code>journalctl</code>.</p>
To get Home Assistant's logging output, simple use <code>journalctl</code>.
```bash
sudo journalctl -f -u home-assistant
```
</div> <!-- FEDORA -->
</div> <!-- SYSTEMD -->
###[&laquo; Back to Getting Started](/getting-started/index.html)

4
source/getting-started/index.markdown
View File

@ -74,7 +74,7 @@ hass \-\-open-ui
<h3>Troubleshooting</h3>
<p>If you run into any issues, please see the <a href='{{site_root}}/getting-started/troubleshooting.html'>troubleshooting page</a>. It contains solutions to many of the common issues.</p>
<p>If you run into any issues, please see the <a href='{{site_root}}/getting-started/troubleshooting.html'>troubleshooting page</a>. It contains solutions to many of the more commonly encountered issues.</p>
<p>For additional help, in addition to this site, there are three sources:
<ul>
@ -99,4 +99,4 @@ pip install \-\-upgrade \-\-pre homeassistant
<p>From here you may now start configuring Home Assistant to your liking. For more advanced users, the <a href='{{site_root}}/getting-started/advanced.html'>advanced configuration page</a> contains brief tutorials on creating more advanced installations.</p>
###[Next step: configuring Home Assistant &raquo;](/getting-started/configuration.html)
###[Next step: Configuring Home Assistant &raquo;](/getting-started/configuration.html)