---
title: "Homarr System Health Monitoring Widget"
aliases: [homarr-health-monitoring, homarr-system-health]
tags: [homarr, homelab, monitoring, widgets, proxmox, truenas, glances]
sources: [raw/System Health Monitoring  Homarr documentation.md]
created: 2026-04-19
updated: 2026-04-19
---

## System Health Monitoring Widget

Displays CPU, memory, disk, and uptime data across one or more systems directly on a Homarr board tile. Has two tabs: **System** (single host) and **Cluster** (Proxmox nodes/VMs/LXCs/storage).

## Supported Integrations

| Integration | Notes |
|------------|-------|
| **Dash.** | System performance & resource monitoring |
| **Open Media Vault** | Free Debian-based NAS server |
| **TrueNAS** | Enterprise/home NAS platform |
| **Glances** | Cross-platform system monitoring tool |
| **Proxmox** | Cluster tab only; one integration at a time |

## Configuration Options

| Option | Description | Default |
|--------|-------------|---------|
| CPU Temp in Fahrenheit | Toggle °F vs °C | no (Celsius) |
| Show CPU Info | CPU usage on System tab | yes |
| Show Memory Info | RAM usage on System tab | yes |
| Show Uptime | Uptime on Cluster tab | yes |
| Show Filesystem Info | Disk usage on System tab | yes |
| Default tab | Which tab opens first (System or Cluster) | System |
| Visible cluster sections | Nodes, VMs, LXCs, Storage | All four |
| Section indicator requirement | Green indicator when **All** or **Any** items online | All |

## Key Takeaways

- Two-tab design: **System tab** (CPU/RAM/disk from Dash./OMV/TrueNAS/Glances) and **Cluster tab** (Proxmox nodes, VMs, LXCs, storage pools)
- Proxmox cluster tab supports **only one integration at a time**
- Section indicator can be set to `All` (all nodes must be online for green) or `Any` (at least one online) — useful for HA clusters vs single-node setups
- Temperature display is °C by default; toggle to °F if needed
- Add the widget via the standard Homarr widget flow — see [[wiki/homelab/homarr-app-widget|App Widget]] docs for the general widget-add pattern

## Related Articles

- [[wiki/homelab/homarr-proxmox-integration|Homarr Integration — Proxmox]] — API token setup required for the Cluster tab
- [[wiki/homelab/homarr-docker-stats|Homarr Docker Stats Widget]] — container-level CPU/memory monitoring
- [[wiki/homelab/homarr-integrations|Homarr Integrations]] — how to create & manage integration credentials
- [[wiki/homelab/homarr-tasks|Homarr Tasks]] — background jobs that drive real-time widget refresh intervals

## Sources

- [System Health Monitoring | Homarr documentation](https://homarr.dev/docs/widgets/health-monitoring/) (v1.59.2)
