Skip to content

Installation Guide

Step-by-step guide to installing LuceDev Syslog Server on Windows or Linux.

Prerequisites

Before installing, ensure your system meets the minimum requirements.

  • Windows 10 or later (64-bit), or Windows Server 2019+
  • .NET Framework 4.6.1 or later
  • Administrator access
  • Network connectivity on ports UDP 514, TCP 6514, and TCP 5000
  • Ubuntu 22.04 or 24.04 (64-bit)
  • sudo / root access
  • Network connectivity on ports UDP 514, TCP 6514, and TCP 5000

Download

Download the latest installer from lucedev.com/products/lucedev-syslog.

Install

  1. Right-click LuceDevSyslog_Setup_{version}.exe and select Run as administrator
  2. Accept the license agreement
  3. Choose the installation directory (default: C:\Program Files\LuceDev Syslog)
  4. Click Install

The installer will automatically:

  • Copy application files to the install directory
  • Create a data folder for the SQLite database
  • Create a logs folder for application logs
  • Create a certs folder for TLS certificates
  • Create an archives folder for compressed log archives
  • Register the LuceDevSyslog Windows service
  • Start the service
  • Add Windows Firewall rules for UDP 514 and TCP 5000
  • Open the dashboard in your default browser

  1. Download the archive:

    wget https://lucedev.com/static/downloads/LuceDevSyslog_v1.2.0_linux_amd64.tar.gz

  2. Extract it:

    tar -xzf LuceDevSyslog_v1.2.0_linux_amd64.tar.gz

  3. Run the installer:

    cd LuceDevSyslog
sudo bash install.sh

The installer will automatically:

  • Copy application files to /opt/lucedev-syslog/
  • Create a lucedev system user to run the service
  • Create data directories at /var/lib/lucedev-syslog/ and /var/log/lucedev-syslog/
  • Register and start the lucedev-syslog systemd service
  • Add UFW firewall rules for UDP 514, TCP 6514, and TCP 5000
  • Print the dashboard URL on completion

Verify Installation

Check the Service

Open Services (Win+R → services.msc) and look for LuceDev Syslog. It should show status Running with startup type Automatic.

You can also verify from the command line:

sc query LuceDevSyslog

Check the Service

sudo systemctl status lucedev-syslog

The service should show active (running).

Check the Dashboard

Open your browser to http://<server-ip>:5000. You should see the login screen.

Check Syslog Reception

From another device on your network, send a test syslog message:

# Linux/macOS
logger -n <server-ip> -P 514 "Test syslog message from $(hostname)"

# PowerShell (from another Windows machine)
$udp = New-Object System.Net.Sockets.UdpClient
$bytes = [Text.Encoding]::ASCII.GetBytes("<14>Test syslog message from PowerShell")
$udp.Send($bytes, $bytes.Length, "<server-ip>", 514)
$udp.Close()

The message should appear on the dashboard within seconds.

Installation Directory Structure

C:\Program Files\LuceDev Syslog\
├── LuceDevSyslog.exe          # Main application
├── LuceDevSyslog-service.exe  # WinSW service wrapper
├── LuceDevSyslog-service.xml  # Service configuration
├── lucedev.ico                # Application icon
├── open_dashboard.bat         # Dashboard launcher
├── settings.json              # Server configuration
├── data/                      # SQLite database
│   └── syslog.db
├── logs/                      # Application logs
├── certs/                     # TLS/HTTPS certificates
└── archives/                  # Compressed log archives

/opt/lucedev-syslog/           # Application files (read-only)
├── LuceDevSyslog              # Main application binary
├── install.sh
├── uninstall.sh
└── lucedev-syslog.service

/var/lib/lucedev-syslog/       # User data (preserved across upgrades)
├── data/                      # SQLite database
│   └── syslog.db
├── certs/                     # TLS/HTTPS certificates
├── archives/                  # Compressed log archives
└── settings.json              # Server configuration

/var/log/lucedev-syslog/       # Application logs

Data Directory

The data, logs, certs, and archives folders contain user data and are preserved during upgrades. Do not delete these unless you want to start fresh.

Default Credentials

Field Value
Username admin
Password password

You will be required to change the default password on first login.

Firewall Rules

The installer automatically creates two Windows Firewall rules:

Rule Name Protocol Port Direction
LuceDev Syslog - UDP UDP 514 Inbound
LuceDev Syslog - Web Dashboard TCP 5000 Inbound

If you enable TLS syslog (TCP 6514) or change any default ports, you'll need to add firewall rules manually.

The installer automatically adds UFW rules:

Protocol Port Description
UDP 514 Syslog receiver
TCP 6514 TLS syslog
TCP 5000 Web dashboard

If UFW is not active on your system, these rules are added but have no effect until UFW is enabled.

See Ports & Firewall for details.

Next Steps