LOGS Server Configuration

This document describes the structure and options available in the LOGS server configuration file. The configuration is typically provided in TOML format (see below) and controls server, database, paths, features, and other operational settings.

Minimal Example Configuration

Below is a minimal configuration that satisfies all required fields:

[Server]
HttpPort = 8080
ListenAddress = "0.0.0.0"
AllowHttp = true

[Database]
User = "logsuser"
Password = "logspassword"
Host = "localhost"
Database = "logsdb"

[Paths]
Files = "/opt/logs/files"
Cache = "/opt/logs/cache"
Config = "/opt/logs/config"
Logs = "/opt/logs/log"
Apps = "/opt/logs/apps"

[SystemPaths]
Parsing = "/opt/logs/system/parsing"

[[Groups]]
Id = "example"
Enabled = true

Full Example Configuration

Below is a more complex configuration:

[Server]
HttpPort = 8080
HttpsPort = 8443
ListenAddress = "0.0.0.0"
AllowHttp = true
AcmeWellKnownPath = "/.well-known/acme-challenge"
CertificatePath = "/etc/ssl/certs/server.crt"
KeyPath = "/etc/ssl/private/server.key"

[Server.Hsts]
MaxAge = 31536000
IncludeSubdomains = true

[Database]
User = "logsuser"
Password = "logspassword"
Host = "localhost"
Database = "logsdb"
Port = 5432

[ControlPlane]
Host = "localhost"
Port = 9000
Secret = "supersecret"

[Paths]
Files = "/opt/logs/files"
Cache = "/opt/logs/cache"
Config = "/opt/logs/config"
Logs = "/opt/logs/log"
Temp = "/opt/logs/tmp"
Apps = "/opt/logs/apps"
Licenses = "/opt/logs/licenses"


[SystemPaths]
Chromium = "/snap-bin-chrome"

# This is the configuration for the example group
[[Groups]]
Id = "example"
Enabled = true

[Groups.Features]
Enable2FA = true
# End of the example group config

# These are globally enabled feature flags
[Features]
Enable2FA = true

Configuration Sections

[Server]

• HttpPort (int, optional): HTTP port to listen on.
• HttpsPort (int, optional): HTTPS port to listen on.
• ListenAddress (string, required): IP address to bind (e.g., "0.0.0.0").
• AllowHttp (bool): Allow HTTP connections.
• AcmeWellKnownPath (string): Path for ACME challenges.
• CertificatePath (string): Path to SSL certificate (required for HTTPS).
• KeyPath (string): Path to SSL key (required for HTTPS).

[Server.Hsts]

• MaxAge (int): HSTS max age in seconds.
• IncludeSubdomains (bool): Apply HSTS to subdomains.

[Database]

• User (string, required): Database username.
• Password (string, required): Database password.
• Host (string, required): Database host.
• Database (string, required): Database name.
• Port (int, optional): Database port.

[Paths]

• Files (string, required): Path for file storage.
• Cache (string, required): Path for cache storage.
• Config (string, required): Path for config files.
• Logs (string, required): Path for logs.
• Temp (string): Path for temporary files.

[SystemPaths]

• Chrome (string): Path to Chrome binary.

[[Groups]]

• Map of group names to group settings:
  • Enabled (bool): Whether the group is enabled.
  • [Groups.Features]: Feature flags for the group.