diff --git a/source/_ecosystem/init.d.markdown b/source/_ecosystem/init.d.markdown new file mode 100644 index 00000000000..5bbac1908a1 --- /dev/null +++ b/source/_ecosystem/init.d.markdown @@ -0,0 +1,137 @@ +--- +layout: page +title: "init.d daemon" +description: "Documentation about setting up Home Assistant as a daemon within init.d." +release_date: 2016-12-02 15:00:00 -0700 +sidebar: true +comments: false +sharing: true +footer: true +--- + +Home Assistant can run as a daemon within init.d with the script below. + +### {% linkable_title 1. Copy script %} + +Copy the script at the end of this page to `/etc/init.d/hass-daemon`. + +After that, set the script to be executable: + +``` +sudo chmod +x /etc/init.d/hass-daemon +``` + +### {% linkable_title 2. Select a user. %} + +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 %} + +``` +sudo update-rc.d hass-daemon defaults +``` + +### {% linkable_title 4. Install this service %} + +``` +sudo service hass-daemon install +``` + +### {% linkable_title 5. Restart Machine %} + +That's it. Restart your machine and Home Assistant should start automatically. + +If HA does not start, check the log file output for errors at `/var/opt/homeassistant/home-assistant.log` + +### {% linkable_title Extra: Running commands before hass executes %} + +If any commands need to run before executing hass (like loading a virutal environment), put them in PRE_EXEC. This command must end with a semicolon. + +### {% linkable_title Daemon script %} + +``` +#!/bin/sh +### BEGIN INIT INFO +# Provides: hass +# Required-Start: $local_fs $network $named $time $syslog +# Required-Stop: $local_fs $network $named $time $syslog +# Default-Start: 2 3 4 5 +# Default-Stop: 0 1 6 +# Description: Home\ Assistant +### END INIT INFO + +# /etc/init.d Service Script for Home Assistant +# Created with: https://gist.github.com/naholyr/4275302#file-new-service-sh +PRE_EXEC="" +RUN_AS="USER" +PID_FILE="/var/run/hass.pid" +CONFIG_DIR="/var/opt/homeassistant" +FLAGS="-v --config $CONFIG_DIR --pid-file $PID_FILE --daemon" +REDIRECT="> $CONFIG_DIR/home-assistant.log 2>&1" + +start() { + if [ -f $PID_FILE ] && kill -0 $(cat $PID_FILE) 2> /dev/null; then + echo 'Service already running' >&2 + return 1 + fi + echo 'Starting service…' >&2 + local CMD="$PRE_EXEC hass $FLAGS $REDIRECT;" + su -c "$CMD" $RUN_AS + echo 'Service started' >&2 +} + +stop() { + if [ ! -f "$PID_FILE" ] || ! kill -0 $(cat "$PID_FILE") 2> /dev/null; then + echo 'Service not running' >&2 + return 1 + fi + echo 'Stopping service…' >&2 + kill $(cat "$PID_FILE") + while ps -p $(cat "$PID_FILE") > /dev/null 2>&1; do sleep 1;done; + echo 'Service stopped' >&2 +} + +install() { + echo "Installing Home Assistant Daemon (hass-daemon)" + echo "999999" > $PID_FILE + chown $RUN_AS $PID_FILE + mkdir -p $CONFIG_DIR + chown $RUN_AS $CONFIG_DIR +} + +uninstall() { + echo -n "Are you really sure you want to uninstall this service? That cannot be undone. [yes|No] " + local SURE + read SURE + if [ "$SURE" = "yes" ]; then + stop + rm -fv "$PID_FILE" + echo "Notice: The config directory has not been removed" + echo $CONFIG_DIR + update-rc.d -f hass-daemon remove + rm -fv "$0" + echo "Home Assistant Daemon has been removed. Home Assistant is still installed." + fi +} + +case "$1" in + start) + start + ;; + stop) + stop + ;; + install) + install + ;; + uninstall) + uninstall + ;; + restart) + stop + start + ;; + *) + echo "Usage: $0 {start|stop|restart|install|uninstall}" +esac +``` \ No newline at end of file diff --git a/source/_ecosystem/nginx.markdown b/source/_ecosystem/nginx.markdown index 4c528f467ef..3ce756a0b30 100644 --- a/source/_ecosystem/nginx.markdown +++ b/source/_ecosystem/nginx.markdown @@ -74,6 +74,8 @@ Double check this configuration to ensure all settings are correct and start ngi Forward ports 443 and 80 to your server on your router. Do not forward port 8123. +### {% linkable_title NGINX Config %} + ``` http { map $http_upgrade $connection_upgrade {