feat: add Spencer — real-time server monitoring dashboard

[ipetinate]

Spencer — Real-time server monitoring dashboard

Version: v0.3.0
Repo: https://github.com/ipetinate/spencer
Docker Hub: https://hub.docker.com/r/ipetinate/spencer

What is Spencer?

Spencer is a lightweight, fully self-hosted server monitoring dashboard with a modern drag-and-drop UI.

Metrics covered:

• CPU — aggregate usage + per-core breakdown with sparklines
• Memory — used/available/swap with history chart
• Disk — usage per partition with visual bars
• Network — per-interface rx/tx with live charts
• Temperature — all sensors displayed as gauge dials (native Linux only)
• GPU — usage, VRAM, temperature, power via nvidia-smi or rocm-smi (native Linux only)
• Processes — sortable table with configurable columns and inline detail popover

UI highlights:

• Drag-and-drop + resizable widget grid (persisted across reloads)
• 10 themes (dark/light variants: Nord, Dracula, Catppuccin, Solarized, GitHub…)
• PWA-installable as a standalone desktop/mobile app
• Configurable UI scale (useful for TV/large monitor setups)
• Widget visibility manager — show/hide widgets with drag-and-drop in Settings
• Real-time updates via Server-Sent Events (SSE)
• Optional Bearer-token authentication (SPENCER_AUTH=true)

Docker Compose changes in this update (v0.3.0)

• Added TZ environment variable for correct timezone display
• Added /host/root bind mount (required for disk usage metrics)
• Added healthcheck for container health monitoring
• Added description metadata for all volumes
• Updated description to mention GPU monitoring support

Requirements

The volume mounts (/proc, /sys, /dev, /) are read-only and required for full metric coverage. Without them Spencer will run but metrics will be limited.

[ipetinate]

CI failure is not caused by Spencer

The build check failure is a pre-existing bug in Apps/Etherpad/docker-compose.yml, unrelated to this PR.

The Spencer file validates cleanly:

./Apps/Spencer/docker-compose.yml
pass validate

The crash happens on the next file the validator processes:

./Apps/Etherpad/docker-compose.yml
ERROR: failed to parse docker-compose file runtime error: invalid memory address or nil pointer dereference

I confirmed this locally by running casaos-app-management-validator against both files:

• ✅ Spencer/docker-compose.yml → pass validate
• ❌ Etherpad/docker-compose.yml → ERROR: nil pointer dereference

The Etherpad compose has multiline environment variables with newlines and special characters (DEFAULT_PAD_TEXT) that appear to trigger a bug in the validator. This issue exists on main independently of this PR.

Could this be merged despite the pre-existing CI failure, or would you prefer to fix Etherpad first? Happy to open a separate PR for that.

[sonarqubecloud]

Quality Gate passed

Issues
0 New issues
0 Accepted issues

Measures
0 Security Hotspots
0.0% Coverage on New Code
0.0% Duplication on New Code

See analysis details on SonarQube Cloud