Skip to content

Syslog server

Arie J. Godschalk edited this page Nov 15, 2026 · 3 revisions

Syslog server

Syslog devices · Home

The Syslog server listens for messages from external Syslog senders and can add the received entries to Simple (Sys) Log.

Set up a receiver

  1. Add the Syslog server device and choose a listening port. If the default port 514 does not start, use a port such as 1514.
  2. Configure each external sender with Homey's LAN address, the same port and TCP transport.
  3. Keep Log all received Syslogs to the default Simple Log enabled if you want the received messages stored locally.
  4. Send a test message and check the log in the app settings.

Settings

Setting Purpose and default
Port Listening port; defaults to 514.
Transport mode The settings offer TCP and UDP, with TCP as the default. See the transport note below.
App name, Hostname These settings are shown on the device, but the current receiver uses the application/tag and hostname from each incoming Syslog message instead.
Log all received Syslogs to the default Simple Log On by default. Turn it off to keep receiving messages without adding them to the local log.

The listener accepts RFC 3164 and RFC 5424 style messages. A received entry uses the message body as its log message, the Syslog tag as its group/App, and the incoming severity, facility, timestamp and hostname as metadata. See Severity levels and Categories for the numeric severity and facility values. Messages the parser cannot recognize, or that do not contain a hostname, are not added to the local log.

Port and transport notes

  • Port 514 is the default, but ports below 1024 may fail because the Homey app process may not have permission to bind them. If the server does not start, choose a port such as 1514 and configure senders to use it too.
  • The current server implementation listens over TCP. Although the device settings offer UDP, the current receiver does not honor that selection. Use TCP for senders.
  • The listener binds to all available network interfaces. Syslog traffic is not authenticated or encrypted by this device; keep it on a trusted network and do not expose its port directly to the Internet.

Next: check the log, or follow troubleshooting if your test is missing.

Clone this wiki locally