How monstercouch/homelab-rmm works
Homelab RMM is a self-hosted remote monitoring and management product. Technicians use the web console to enroll and manage devices, then monitor inventory and metrics or dispatch scripts, patches, and baseline policies; outbound-connected agents execute device work and report results to the server. The product also includes remote access, ticketing and a client portal, discovery, signed actions, and configurable metrics storage. The README documents the main capabilities and flows; source excerpts are partial, so some subsystem connections are documented rather than verified in implementation.
Main entry points: server.go RMM Server · agent.go Device Agent · App.tsx Web Console · ClientPortal.tsx Client Portal
Components 22
Web Console
- Web Console
web/src/App.tsx - API Client
web/src/api/client.ts - Console Auth
web/src/state/auth.tsx
Server Control Plane
- RMM Server
internal/server/server.go - Server Entrypoint
cmd/rmm-server/main.go - Application Database
internal/server/db.go
Device Management
- Device Agent
internal/agent/agent.go - Agent Protocol
internal/protocol/protocol.go - Metrics and Inventory
internal/agent/inventory.go - Scripts and Tasks
internal/server/runs.go - Patch Management
internal/server/patches.go - Baseline Compliance
internal/server/baselines.go - Remote Device Tools
internal/agent/desktop_start.go - Network Discovery
internal/server/discovery.go
Support and Access
- Client Portal
web/src/pages/portal/ClientPortal.tsx - IT Ticketing
internal/server/tickets.go - Desktop Companion
cmd/rmm-desktop/main.go
Trust and Storage
- Signed Actions
internal/actionauth/verifier.go - Action Signer
cmd/rmm-signer/main.go - Metrics Storage
internal/telemetry/store.go
Other components
- Technician
- SMTP Mail
Connections 23
- Technician → Web Console: manages fleet
README.md - Web Console → Console Auth: checks session
web/src/App.tsx - Web Console → API Client: requests data
web/src/api/client.ts - API Client → RMM Server: calls API
README.md - Server Entrypoint → RMM Server: starts
cmd/rmm-server/main.go - RMM Server → Application Database: reads and writes
- Device Agent → RMM Server: connects outbound
README.md - Device Agent → Agent Protocol: uses protocol
- Device Agent → Metrics and Inventory: reports telemetry
README.md - RMM Server → Metrics and Inventory: stores history
README.md - RMM Server → Scripts and Tasks: dispatches runs
README.md - RMM Server → Patch Management: dispatches updates
README.md - Device Agent → Baseline Compliance: evaluates checks
README.md - RMM Server → Baseline Compliance: assigns policies
README.md - RMM Server → Remote Device Tools: relays sessions
README.md - RMM Server → Network Discovery: runs discovery
README.md - Client Portal → IT Ticketing: submits tickets
README.md - Client Portal → API Client: requests services
web/src/pages/portal/ClientPortal.tsx - Desktop Companion → Client Portal: supports self-service
- Action Signer → Signed Actions: signs actions
cmd/rmm-signer/main.go - RMM Server → Signed Actions: verifies actions
internal/server/server.go - RMM Server → Metrics Storage: stores metrics
internal/server/server.go - RMM Server → SMTP Mail: sends alerts
README.md