Skip to main content
Run the relay as a systemd service so it starts with the host and automatically recovers from process failures.

​
Create the service unit

Create:
Example:
Replace the example user, group, working directory, script path, destination addresses, and ports with values for your environment.

​
Enable and start

After changing the unit file:

​
Follow service logs

To inspect the effective unit file:

​
Automatic recovery

The recommended service settings are:
This allows systemd to restart the daemon after a process failure without creating an immediate tight restart loop.

​
Operational features

The relay is designed for continuous operation and includes:
  • Fetch checkpointing
  • Send retry/recovery
  • Backfill
  • Separate alert and case destinations

​
Operational tips

  • Keep Restart=on-failure enabled for automatic process recovery.
  • Use --debug only when troubleshooting.
  • Verify TCP reachability from the relay host to every configured destination.
  • Use separate alert and case listeners when the downstream workflows differ.
  • After editing the unit file, always run systemctl daemon-reload before restarting the service.

Configuration

Review stream requirements and available options.

Troubleshooting

Diagnose configuration and delivery problems.