# HW-Monitor

HW-Monitor is a self-hosted monitoring & logging app. Lightweight web dashboard for monitoring CPU, GPU, disk, and motherboard temps and voltages on Linux and Unraid, with live charts and SQLite-backed history. It is open source and self-hosted, installable on Unraid.

Canonical page: https://ourlocalhost.com/app/2910/hw-monitor

## Description

Lightweight web dashboard for monitoring CPU, GPU, disk, and motherboard temps and voltages on Linux and Unraid, with live charts and SQLite-backed history.

## Platform availability

Available on 1 of 10 platforms: Unraid.

## Health score

38/100 (Low), based on 4 of 4 factors.
- Maintained: 52 (last commit 206 days ago)
- Popular: 0 (0 GitHub stars)
- Easy to install: 35 (1 install platform, install notes, Docker image)
- Light to run: 70 (1 GB minimum RAM)

## Links

- Unraid: https://ca.unraid.net/apps/hw-monitor-0i34rw41mkojrc?q=HW-Monitor

## Common questions

### Where does HW Monitor keep historical metrics for backup?

In Docker deployments, history is stored under the ./data directory, with longer-range data kept in SQLite.

### Which environment variables must be set before starting the app?

Set at least AUTH_PASS and SECRET_KEY in the .env file before running the container.

### What port does the dashboard use by default?

The dashboard serves on port 8181 by default.

### What Linux permissions are required for SMART disk monitoring in Docker?

Mount the host /dev and /sys into the container, usually with /sys read-only, and add the SYS_ADMIN and SYS_RAWIO capabilities. The Unraid template adds those capabilities automatically.

### How are GPU sensors enabled?

NVIDIA support turns on automatically when nvidia-smi is present. AMD and Intel GPU readings use sysfs/hwmon and depend on kernel and driver versions.

---
Source: Our Local Host (https://ourlocalhost.com/app/2910/hw-monitor), the self-hosted and open-source app directory.
