# homelab-monitor

> Self-hosted homelab dashboard monitoring GPU, AI VRAM, Docker, systemd, disks, network and power costs across machines over SSH with a read-only MCP server.

- **Category:** Monitoring & observability
- **Licence:** MIT
- **Latest version:** v0.37.0
- **Open source:** oss
- **Languages:** Python, HTML
- **Platforms:** Docker Compose, Windows
- **Tags:** Monitoring, Dashboard, Mcp, Mcp Server, Ai Agents, Sysadmin, Homelab, Local Ai, LLM, Claude, Nvidia, Gpu, Ollama, Ssh, Cost Tracking, Docker, Self Hosted, Agentic, Model Context Protocol, Gpu Monitoring, Systemd, Multi host, Ai infrastructure, Benchmarking, Power Monitoring, Vram, AI ML

## Description

HomeLab Monitor is a single-container, self-hosted dashboard that puts your entire home lab and AI rig on one page. It shows live GPU utilisation, VRAM, power draw, temperature and identifies which container or process is using each GPU — supporting NVIDIA, AMD and Intel GPUs on Linux and Windows. It tracks Docker container health with separate RAM and VRAM columns, systemd services, interactive disk treemaps, network interfaces and listening sockets, plus a read-only security posture check covering firewall, SSH, SELinux/AppArmor and fail2ban. Power consumption is measured per component and per process, container or model, with day/night tariffs and a weekly busy-hours heatmap. A Benchmark Lab sweeps local Ollama models across context sizes to find the largest context fitting in VRAM. Multi-machine monitoring works agentless over SSH — just add the hub's key to each remote (Linux, Raspberry Pi, or Windows). A built-in read-only MCP server on port 9810 lets AI agents explore the homelab through 19 tools. Alerts go to Discord, ntfy.sh, Telegram, Email, Slack or generic webhooks. Runs without a separate metrics stack or cloud dependency, no login required — meant for a trusted LAN/VPN. History persists in SQLite (./data/gpu.db).

## Links

- [Homepage](https://github.com/SikamikanikoBG/homelab-monitor)
- [Website](https://sikamikanikobg.github.io/homelab-monitor/)
- [Docker](sikamikaniko123/homelab-monitor)
- [Discord Community](https://discord.gg/tpKWKEdSQN)
- [GitHub Repository](https://github.com/SikamikanikoBG/homelab-monitor)
- [Docker Hub](https://hub.docker.com/r/sikamikaniko123/homelab-monitor)
- [Install Guide](https://sikamikanikobg.github.io/homelab-monitor/install/)
- [Features Tour](https://sikamikanikobg.github.io/homelab-monitor/features/)
- [Multi-machine Guide](https://sikamikanikobg.github.io/homelab-monitor/multi-host/)
- [Configuration Reference](https://sikamikanikobg.github.io/homelab-monitor/configuration/)
- [MCP Server Docs](https://sikamikanikobg.github.io/homelab-monitor/mcp/)
- [Security Model](https://sikamikanikobg.github.io/homelab-monitor/security/)

---
Source: https://selfhost.directory/project/homelab-monitor