Introducing Syslog Receiver – A New HACS Integration for Ingesting Syslog into Home Assistant

Share your Projects! Custom Integrations
1

:mega: I’m excited to share my first HACS integration: Syslog Receiver!

With this custom integration, you can:

  • Listen for syslog messages over UDP, TCP, or encrypted TCP (TLS)
  • Filter incoming logs by source IP and severity level
  • Fire Home Assistant events (syslog_receiver_message) for automations
  • Optionally expose the last‐message sensor for each listener
  • Configure everything via the UI—no YAML required

:wrench: Quick Start via HACS

  1. In HACS, search for Syslog Receiver, or click on the “Add Repository” button and add repository URL https://github.com/zollak/homeassistant-syslog-receiver.
  2. Download, then Restart Home Assistant.

:gear: Configure Your Listener
Go to Settings → Devices & Services → Add Integration and select Syslog Receiver. You’ll be prompted to set:

  • Instance Name (e.g. “Syslog Receiver UDP”)
  • Host (e.g. 0.0.0.0 or a specific IP from any HA interface where you would listen for the incoming syslog packets)
  • Port (e.g. 514 for syslog packets or you can set custom port)
  • Protocol: UDP, TCP, or TCP+TLS
  • TLS certfile/keyfile (if using encrypted syslog)
  • Allowed IPs (comma-separated whitelist)
  • Minimum Severity threshold
  • Enable Sensor toggle (to create a sensor.syslog_receiver_<id>)

:dart: Use Cases

  • Trigger automations on specific log patterns or error levels
  • Dashboard view: show the latest syslog entry via the sensor
  • Multi-instance: run separate listeners for different protocols
# Example automation: notify on critical syslog errors
trigger:
  platform: event
  event_type: syslog_receiver_message
condition:
  condition: template
  value_template: "{{ trigger.event.data.severity <= 2 }}"
action:
  service: notify.mobile_app
  data:
    title: "[SYSLOG ERROR] {{ trigger.event.data.source_ip }}"
    message: "{{ trigger.event.data.message }}"

:books: Learn More & Contribute

I’d love your feedback, bug reports, or pull requests! Let me know how you’re using it in your setups. :pray:t3:

2 Likes