Repository navigation
Syslog server
The Syslog server listens for messages from external Syslog senders and can add the received entries to Simple (Sys) Log.
- Add the Syslog server
device and choose a listening port. If the default port
514does not start, use a port such as1514. - Configure each external sender with Homey's LAN address, the same port and TCP transport.
- Keep Log all received Syslogs to the default Simple Log enabled if you want the received messages stored locally.
- Send a test message and check the log in the app 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
514is the default, but ports below1024may fail because the Homey app process may not have permission to bind them. If the server does not start, choose a port such as1514and 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.
Support development - If Simple (Sys) Log is useful to you, you can support its
continued development through GitHub Sponsors,
Patreon,
PayPal, or
bunq.
Thank you!