From f2ec8c291f92b4ed4bf4ff5bf2d12ab504c7afd2 Mon Sep 17 00:00:00 2001
From: Fermulator <github@fermulator.fastmail.org>
Date: Sat, 21 Oct 2017 11:35:57 -0400
Subject: [PATCH] update init.d daemon script to specify HASS_BIN (#3700)

* update init.d daemon script to specify HASS_BIN

As per:
 * https://home-assistant.io/docs/autostart/init.d/
, coupled with:
 * https://home-assistant.io/docs/installation/virtualenv/

It's obvious that the user needs to replace "RUN_AS" with the correct user.
What can be made more clear is to include a "HASS_BIN" shell variable, with a similar instruction to update that if needed.

Note that I opted NOT to change the HASS_BIN to the full path /usr/bin/hass, as the previous revision presumably assumes that the `hass` binary is in the $PATH env for whatever user is running it ... (didn't want to change that).

* Fix name
---
 source/_docs/autostart/init.d.markdown | 14 ++++++++++----
 1 file changed, 10 insertions(+), 4 deletions(-)

diff --git a/source/_docs/autostart/init.d.markdown b/source/_docs/autostart/init.d.markdown
index 96f0509059b..9f67cbdb2b5 100644
--- a/source/_docs/autostart/init.d.markdown
+++ b/source/_docs/autostart/init.d.markdown
@@ -26,19 +26,23 @@ $ sudo chmod +x /etc/init.d/hass-daemon
 
 Create or pick a user that the Home Assistant daemon will run under. Update script to set `RUN_AS` to the username that should be used to execute hass.
 
-### {% linkable_title 3. Register the daemon with Linux %}
+### {% linkable_title 3. Change hass executable if required. %}
+
+Some installation environments may require a change in the Home Assistant executable `hass`. Update script to set `HASS_BIN` to the appropriate `hass` executable path.
+
+### {% linkable_title 4. Register the daemon with Linux %}
 
 ```bash
 $ sudo update-rc.d hass-daemon defaults
 ```
 
-### {% linkable_title 4. Install this service %}
+### {% linkable_title 5. Install this service %}
 
 ```bash
 $ sudo service hass-daemon install
 ```
 
-### {% linkable_title 5. Restart Machine %}
+### {% linkable_title 6. Restart Machine %}
 
 That's it. Restart your machine and Home Assistant should start automatically.
 
@@ -64,6 +68,8 @@ If any commands need to run before executing hass (like loading a virtual enviro
 # /etc/init.d Service Script for Home Assistant
 # Created with: https://gist.github.com/naholyr/4275302#file-new-service-sh
 PRE_EXEC=""
+# Typically /usr/bin/hass
+HASS_BIN="hass"
 RUN_AS="USER"
 PID_FILE="/var/run/hass.pid"
 CONFIG_DIR="/var/opt/homeassistant"
@@ -76,7 +82,7 @@ start() {
     return 1
   fi
   echo 'Starting service…' >&2
-  local CMD="$PRE_EXEC hass $FLAGS $REDIRECT;"
+  local CMD="$PRE_EXEC $HASS_BIN $FLAGS $REDIRECT;"
   su -c "$CMD" $RUN_AS
   echo 'Service started' >&2
 }