🎉 Homelable v1.0.0
First stable release of Homelable — a self-hosted infrastructure visualization tool for your homelab.
⚠️ This is the first public release. Core features are working but some areas are still rough around the edges. Expect bugs, missing polish, and the occasional surprise. Contributions and issues welcome!
✨ What's included
Canvas & Visualization
- Interactive network diagram canvas powered by React Flow
- 11 node types: ISP, Router, Switch, Server, Proxmox, VM, LXC, NAS, AP, IoT, Generic
- 5 edge types: Ethernet, Wi-Fi, VLAN, Virtual, IoT
- Proxmox nested nodes — VM/LXC rendered as children inside a Proxmox group
- Auto-layout (Dagre), zoom/pan, snap-to-grid
- PNG export
Network Discovery
- nmap-based scanner (
-sV --open) over configurable CIDR ranges - Pending device queue — approve, hide or ignore discovered devices
- Service fingerprinting with SSH / HTTP / HTTPS / VM/LXC badges
- MAC OUI detection to identify QEMU, Proxmox and VMware virtual machines
Status Monitoring
- Per-node health checks: ping, http, https, tcp, ssh, prometheus, /health
- Live status updates via WebSocket
- Scheduled background checks (configurable interval)
Auth & Persistence
- Single-user JWT authentication (bcrypt password hash in
.env) - Canvas state persisted in SQLite, explicit Save button (no auto-save)
Standalone / Frontend-only mode
- Run without a backend — pure diagram editor with localStorage persistence
- No login, no scanner, no health checks
Install options
- Docker Compose (one-liner install script)
- Proxmox LXC (automated container creation + installer)
- Manual Debian/Ubuntu install script