PatchMon
Displays host patch statistics including total hosts, hosts needing updates, and security update counts.
This widget displays patch statistics from your PatchMon instance, including total hosts, hosts needing updates, and security update counts. Each stat is shown with a dedicated icon and severity-tinted card background for quick visual scanning.
PatchMon does not render a built-in widget title. To add a label on your board, open Edit item → Advanced options → Title — the same optional overlay badge used by other Homarr widgets.
Authentication​
This widget requires a signed-in Homarr session. Anonymous visitors cannot load PatchMon data, even when the board is public. Placing this widget on a public board does not expose patch or security statistics to guests.
Stat visibility toggles in the widget settings control display only. Authenticated users with integration query access still receive the full API payload regardless of which stats are hidden in the UI.
Compliance hero​
When Show compliance hero is enabled (default), the widget displays a ring showing the percentage of hosts that are fully up to date. The ring color follows the same threshold rules as the "Up-to-Date Hosts" stat. When the widget is 2 or more columns wide, the hero also shows the "Patch Compliance" label and exact host count (e.g. "27 / 42") beside the ring.
In 1-column-wide layouts (such as 1×1), the compliance hero switches to a ring-only view so useful compliance data remains visible in tight spaces. If the compliance hero is disabled, compact widgets fall back to the next selected content: OS distribution when enabled, then the first enabled stat.
Threshold colors​
When Enable threshold colors is on (default), stat values and card backgrounds are colored for at-a-glance severity:
| Stat | Green | Yellow | Red |
|---|---|---|---|
| Needs Updates | 0 | 1–4 | 5+ |
| Security Updates | 0 | 1–9 | 10+ |
| Hosts with Security Updates | 0 | — | 1+ |
| Up-to-Date Hosts | 100% of total | 90–99% | below 90% |
| Outdated Packages | 0 | 1–49 | 50+ |
Enable Advanced thresholds to override warning and critical values per stat, using either absolute counts or percentages of total hosts.
OS distribution​
When Show OS distribution is enabled, the widget shows a breakdown of monitored hosts by operating system. Two display modes are available:
- Horizontal bars (default) — a scrollable list of colored progress bars showing each OS's share
- Donut chart — a compact donut chart visualization that scales down in narrow layouts
The OS distribution limit defaults to All. A widget size of 2×3 or larger is recommended when using this section alongside the default stats, but compact 1×1 and 2×1 layouts can still show multiple OS rows when OS distribution is the primary selected content. Wider donut layouts can also show a compact legend beside the chart.
Responsive sizing​
The widget adapts its layout based on the available space:
| Widget size | Layout |
|---|---|
| 1×1 | Primary selected content: compliance ring (no label), compact OS distribution, or up to two enabled stats |
| 2×1 / 1×2 | Compact primary content; 2×1 shows compliance label and host ratio beside the ring; 1×2 uses ring-only hero |
| 2×2 (default) | Compliance hero, stat grid with icons, and tinted cards |
| 2×3 / 3×2 | Hero, stats, OS distribution, and "last updated" footer |
| 3×3 or larger | Full layout with up to 4-column stat grid, donut chart, and optional OS legend |
Last updated​
When the widget has enough space, a "last updated" timestamp appears at the bottom showing how recently PatchMon refreshed its data. Narrow layouts use a shortened timestamp such as 5m ago; wider short layouts can show the full translated text.
Supported Integrations​
Adding the widget​
You can find how to add the widget on the Widgets documentation page.
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 |