HomelabMon

HomelabMon is an efficient monitoring solution tailored for homelabs, offering a single-binary, zero-dependency system that facilitates easy discovery and monitoring of various services within your network. With built-in mesh networking capabilities, local LLM (Large Language Model) integration, and an intuitive web dashboard, this tool enhances the management of home systems.

Key Features

• Single Binary: Operate a singular Go binary across multiple platforms, including Linux, macOS, Windows, and Raspberry Pi.
• Pure Mesh System: Each node in the network can function independently as a dashboard, eliminating the need for a master node.
• Auto-Discovery: Seamlessly identify over 60 homelab services, such as Pi-hole, Plex, Jellyfin, and Home Assistant.
• Network Scanning: Perform passive discovery of devices (phones, TVs, IoT devices, printers) through ARP, mDNS, and SNMP techniques.
• Integrations: Supports various devices and services like FRITZ!Box, Unifi, Home Assistant, and Pi-hole, making it adaptable to diverse setups.
• LLM Chat Integration: Use local Ollama integration to query the state of the system with questions like "What's running on my NAS?".
• Lightweight CMDB: Maintain a comprehensive inventory of all devices utilizing an SQLite database.
• Notifications: Set up alerts for host offline statuses or resource threshold breaches using ntfy.sh and webhook notifications.
• Secure Credentials: User credentials are securely stored with AES-256-GCM encryption, ensuring no plain-text passwords are presented in the command line or environment variables.
• External Plugins: Extend functionalities by adding custom plugins in any programming language through a subprocess JSON protocol.

Usage Options

After installation, several command options are available to customize how HomelabMon operates:

homelabmon                                    # Start observing and creating a mesh network
homelabmon --ui                               # Launch web dashboard
homelabmon --scan                             # Activate network scanning
homelabmon --llm http://localhost:11434       # Connect to LLM for queries
homelabmon --peer 192.168.1.10:9600          # Join another node

HomelabMon is designed for easy setup and operation, enabling users to quickly monitor and manage their homelab environments effectively. The architecture allows for scalability, letting users deploy multiple nodes, each contributing to the overall visibility and management of resources in their network.

For more advanced configurations, documentation is available covering design decisions, plugin development, installation methods, and more. Dive into the full capabilities of HomelabMon and experience streamlined homelab monitoring.