On this page

Webserver Configuration

The Webserver has a minimal JSON configuration file for service-level settings, while most operational settings are managed through the Web UI and stored in its embedded key-value database.

Service Configuration (webserver.json)

This file must be in the same directory as the executable.

{
  "HTTPS": "true",
  "PortAPI": "8050",
  "PortWEB": "9090",
  "RunUser": "mugnsoft"
}
Field Type Description Default
HTTPS string Enable HTTPS for both API and Web servers. Set to "true" or "false" "true"
PortAPI string TCP port for the REST API server "8050"
PortWEB string TCP port for the Web UI server "9090"
RunUser string System user to run the service as (Linux only). Leave empty to use the current user ""
Important: Changing the ports or HTTPS setting requires a service restart. Other settings (SMTP, Slack, LDAP, etc.) are configured through the Web UI and do not require edits to this file.

Runtime Settings (via Web UI)

These settings are configured through the Settings page in the Web UI and stored encrypted in the embedded key-value store.

SMTP (Email)

Setting Description
SMTP Server Mail server hostname
SMTP Port Mail server port (25, 465, 587)
SMTP Username Authentication username
SMTP Password Authentication password
SMTP TLS Enable TLS encryption
Sender Email Email address for outgoing messages

Slack Integration

Setting Description
Slack Token Bot token for Slack API
Slack Channel Default channel for notifications

GitLab Integration

Setting Description
GitLab URL GitLab server URL
GitLab Token Personal access token
GitLab Project Project ID for monitor script import

LDAP Integration

Setting Description
LDAP Server LDAP/AD server hostname
LDAP Port Server port (389, 636)
LDAP Base DN Base distinguished name for searches
LDAP Bind DN Bind user distinguished name
LDAP Bind Password Bind user password
LDAP TLS Enable TLS

Logging

Setting Description Default
Log Level debug, info, warn, error info
Max Log Size Maximum log file size (MB) 10
Max Backups Number of rotated log files 5
Max Age Days to keep log files 28
Compress Logs Compress rotated files true

JWT Authentication Settings

These are compiled into the binary and cannot be changed via configuration:

Setting Value
Signing Algorithm RS256
User Token Lifetime 15 minutes
Component Token Lifetime 60 days (1440 hours)
Token Lookup header: Authorization, cookie: jwt
Token Header Bearer
Cookie Name jwt
Cookie HTTPOnly true
Cookie SameSite Lax

File Locations

File/Directory Purpose
webserver.json Service configuration
license_MNS.dat License file (required)
config/sec/mugnsoft_webserver.key RSA private key (JWT signing)
config/sec/mugnsoft_webserver.key.pub RSA public key (JWT verification)
config/ssl/certificates/ TLS certificates
config/ssl/private/ TLS private keys
dbs/webserver.db Main embedded key-value database
dbs/backup/ Automated backups
log/ Application logs

Translations

Monitor Configuration