PatchMon
Health Monitoring
Displays host patch statistics including total hosts, hosts needing updates, and security update counts.
The PatchMon widget shows host compliance, available updates, security updates, outdated packages, and optional operating system distribution. Thresholds can use counts or percentages. Advanced view shows the complete posture summary.
Authentication
PatchMon data requires a signed-in Homarr session, including on public boards. Visibility options change presentation, not the integration response available to an authorized user.
Supported integration
PatchMonPatchMon is a patch management and monitoring solution for Linux hosts, tracking package updates and security patches across your infrastructure.
Supports advanced view. See the advanced keyboard shortcuts.
Adding the widget
Add the widget from the board's Add board content menu in edit mode.
Configuration
| Name | Description | Values | Default value |
|---|---|---|---|
| Show compliance hero | Display a compliance ring showing the percentage of up-to-date hosts | yes / no | yes |
| Show total hosts | Displays the total number of monitored hosts | yes / no | yes |
| Show hosts needing updates | Displays hosts with at least one outdated package | yes / no | yes |
| Show security updates | Displays the total number of security updates available | yes / no | yes |
| Show up-to-date hosts | Displays hosts with zero outdated packages | yes / no | no |
| Show hosts with security updates | Displays hosts requiring security patches | yes / no | no |
| Show recent updates (24h) | Displays the number of updates applied in the last 24 hours | yes / no | no |
| Show outdated packages | Displays the total number of outdated packages across all hosts | yes / no | no |
| Show repositories | Displays the number of active repositories being monitored | yes / no | no |
| Enable threshold colors | Colors stat values green, yellow, or red based on built-in severity presets | yes / no | yes |
| Advanced thresholds | Customize warning and critical thresholds per stat (absolute count or % of total hosts) | yes / no | no |
| Needs updates threshold mode | Compare the needs-updates count as an absolute value or percentage of total hosts. Shown when threshold colors and advanced thresholds are enabled. |
| Absolute count |
| Needs updates warning threshold | Enter yellow when the value reaches this threshold | Integer ≥ 0 | 1 |
| Needs updates critical threshold | Enter red when the value reaches this threshold | Integer ≥ 0 | 5 |
| Security updates threshold mode | Compare the security-updates count as an absolute value or percentage of total hosts. Shown when threshold colors and advanced thresholds are enabled. |
| Absolute count |
| Security updates warning threshold | Enter yellow when the value reaches this threshold | Integer ≥ 0 | 1 |
| Security updates critical threshold | Enter red when the value reaches this threshold | Integer ≥ 0 | 10 |
| Hosts with security updates threshold mode | Compare the host count as an absolute value or percentage of total hosts. Shown when threshold colors and advanced thresholds are enabled. |
| Absolute count |
| Hosts with security updates warning threshold | Enter yellow when the value reaches this threshold | Integer ≥ 0 | 1 |
| Hosts with security updates critical threshold | Enter red when the value reaches this threshold | Integer ≥ 0 | 1 |
| Up-to-date hosts threshold mode | Compare the up-to-date host count as an absolute value or percentage of total hosts. Shown when threshold colors and advanced thresholds are enabled. |
| Percent of total hosts |
| Up-to-date hosts warning threshold | Enter yellow when the value is at or above this threshold but below full coverage | Integer ≥ 0 | 90 |
| Up-to-date hosts critical threshold | Enter red when the value falls below this threshold | Integer ≥ 0 | 90 |
| Outdated packages threshold mode | Compare the outdated-packages count as an absolute value or percentage of total hosts. Shown when threshold colors, advanced thresholds, and Show outdated packages are enabled. |
| Absolute count |
| Outdated packages warning threshold | Enter yellow when the value reaches this threshold | Integer ≥ 0 | 1 |
| Outdated packages critical threshold | Enter red when the value reaches this threshold | Integer ≥ 0 | 50 |
| Show OS distribution | Displays a horizontal bar breakdown of monitored hosts by operating system | yes / no | no |
| OS display mode | Choose how to display the operating system distribution. Shown when Show OS distribution is enabled. |
| Horizontal bars |
| OS distribution limit | Maximum number of operating systems to display in the distribution section |
| All |
| Show OS version | Append the OS version to each distribution label when available | yes / no | yes |