diff --git a/source/components/index.markdown b/source/components/index.markdown index fc87e875cd2..e616ad946f8 100644 --- a/source/components/index.markdown +++ b/source/components/index.markdown @@ -213,6 +213,12 @@ the manufacturers of these devices. Allow sending e-mail messages. + + +Syslog +Allow sending messages to a local syslog. + + Jabber (XMPP) diff --git a/source/components/notify.syslog.markdown b/source/components/notify.syslog.markdown new file mode 100644 index 00000000000..d04ecfab058 --- /dev/null +++ b/source/components/notify.syslog.markdown @@ -0,0 +1,50 @@ +--- +layout: page +title: "Syslog notification support" +description: "Instructions how to add syslog notifications to Home Assistant." +date: 2015-06-09 16:00 +sidebar: false +comments: false +sharing: true +footer: true +--- + +The syslog platform allows you to deliver notifications from Home Assistant to the local syslog. + +To enable syslog notifications in your installation, add the following to your `configuration.yaml` file: + +```yaml +# Example configuration.yaml entry +notify: + platform: syslog + facility: SYSLOG_FACILITY + option: SYSLOG_LOG_OPTION + priority: SYSLOG_PRIORITY +``` + +The table contains values to use in your `configuration.yaml` file. + +| facility | option | priority | +| :-------- |:--------| :---------| +| kernel | pid | 5 | +| user | cons | 4 | +| mail | ndelay | 3 | +| daemon | nowait | 2 | +| auth | perror | 1 | +| LPR | | 0 | +| news | | -1 | +| uucp | | -2 | +| cron | | | +| syslog | | | +| local0 | | | +| local1 | | | +| local2 | | | +| local3 | | | +| local4 | | | +| local5 | | | +| local6 | | | +| local7 | | | + +For details about facility, option, and priority please consult the [wikpedia article](http://en.wikipedia.org/wiki/Syslog) and [RFC 3164](http://tools.ietf.org/html/rfc3164). + +To use notifications, please see the [getting started with automation page]({{site_root}}/components/automation.html).