2024.10.4
Home ▸ Integrations ▸

Syslog

The syslog integrationIntegrations connect and integrate Home Assistant with your devices, services, and more. [Learn more] 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.yamlThe configuration.yaml file is the main configuration file for Home Assistant. It lists the integrations to be loaded and their specific configurations. In some cases, the configuration needs to be edited manually directly in the configuration.yaml file. Most integrations can be configured in the UI. [Learn more] file. After changing the configuration.yamlThe configuration.yaml file is the main configuration file for Home Assistant. It lists the integrations to be loaded and their specific configurations. In some cases, the configuration needs to be edited manually directly in the configuration.yaml file. Most integrations can be configured in the UI. [Learn more] file, restart Home Assistant to apply the changes. The integration is now shown on the integrations page under Settings > Devices & services. Its entities are listed on the integration card itself and on the Entities tab.

# Example configuration.yaml entry
notify:
  - name: NOTIFIER_NAME
    platform: syslog

Configuration Variables

Looking for your configuration file?
name string (Optional, default: notify)

Setting the optional parameter name allows multiple notifiers to be created. The notifier will bind to the notify.NOTIFIER_NAME action.

facility string (Optional, default: syslog)

Facility according to RFC 3164 (https://tools.ietf.org/html/rfc3164). Check the table below for entries.

option string (Optional, default: pid)

Log option. Check the table below for entries.

priority string (Optional, default: info)

Priority of the messages. Check the table below for entries.

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 wikipedia article and RFC 3164.

To use notifications, please see the getting started with automation page.

Related topics