Diagnostics¶

Under Diagnostics, nmg runs a complete self-check of the system and displays the results in a structured view.

Running Diagnostics¶

Click Run Again to trigger a fresh diagnostic pass. The report builds in real time and shows all checks with their status.

Four statistics appear at the top of the page:

Tile	Meaning
OK	Checks with no findings
WARN	Checks with warnings (system works, but action recommended)
FAIL	Critical checks — immediate action required
SKIP	Checks not applicable in this configuration

Column	Description
Status	`ok` (green) / `warn` (yellow) / `fail` (red) / `skip` (grey)
Category	Area of the check (e.g. `postfix`, `rspamd`, `clamav`, `cluster`, `license`)
Label	Human-readable check name
Detail	Technical finding (path, error message, measured value)
Hint	Recommended remediation action
Duration	Check runtime in milliseconds

The table can be filtered by status — show only fail/warn to focus quickly on problems.

Category	Aspects Checked
`postfix`	Service running, queue reachable, TLS certificate valid
`rspamd`	Service running, controller reachable, config test clean
`clamav`	clamd reachable, signatures up to date
`yara`	Rules loaded, last update timestamp
`keydb`	Connection, replication (in cluster)
`postgres`	Connection, migration status
`license`	Valid, expiry date, grace period
`cluster`	Peer reachability, certificate expiry, configuration drift
`disk`	Free space on relevant partitions
`nginx`	Service running, TLS certificates valid

FAIL entries: Fix immediately — they indicate a non-functional service or critical misconfiguration
WARN entries: Fix promptly — e.g. expiring certificates, low disk capacity, or outdated signatures
SKIP entries: Ignore — e.g. cluster checks on a single-node system

Diagnostics after updates

Run diagnostics after every nmg update to ensure all services started correctly and no configuration conflicts occurred.