add syslog page

2025-07-15 21:36:52 +00:00 · 2015-06-09 16:24:45 +02:00 · 2015-06-09 16:24:45 +02:00 · b8b194c994
commit b8b194c994
parent 6badf55823
1 changed files with 48 additions and 0 deletions
--- a/source/components/notify.syslog.markdown
+++ b/source/components/notify.syslog.markdown
@ -0,0 +1,48 @@
+---
+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
+```
+
+| 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 consulte 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).