Self-hosted homelab mapping

Every box. Every link.

Circuit Breaker turns your hardware, VMs, containers, services and networks into one living map—self-hosted, open source, and always up to date.

Map my homelab →Read the docs

206 stars on GitHub · v0.4.6 released on Sep 30, 2026

Live bandwidth. 10G Ethernet to pve1. Every link shows its speed, and traffic moves at its pace. 9.2 Gbps in use
Degraded status. Turns amber on UPS battery. On mains
Connection types. Ethernet, fiber, Wi-Fi, WireGuard, management… each drawn in its own style.
Zones. Group racks, rooms or VLANs.

Internet, external, healthy
- connects to Dream Machine Pro
Hetzner VPS, external, 203.0.113.24, healthy
- from Dream Machine Pro (connects to)
Dream Machine Pro, hardware, 10.0.10.1, healthy
- connects to Hetzner VPS
- connects to USW Pro 24 PoE
- routes Management · VLAN 10
- routes Servers · VLAN 20
- routes IoT · VLAN 30
- from Internet (connects to)
USW Pro 24 PoE, hardware, 10.0.10.2, healthy
- connects to USW Aggregation
- connects to U6 Pro · Living room
- connects to U6 Lite · Office
- connects to APC Smart-UPS 1500
- connects to iDRAC 8
- from Dream Machine Pro (connects to)
USW Aggregation, hardware, 10.0.10.3, healthy
- connects to pve1
- connects to pve2
- connects to pve3
- connects to Dell R730
- connects to TrueNAS Scale
- from USW Pro 24 PoE (connects to)
U6 Pro · Living room, hardware, 10.0.10.21, healthy
- connects to Raspberry Pi 4
- from USW Pro 24 PoE (connects to)
U6 Lite · Office, hardware, 10.0.10.22, healthy
- from USW Pro 24 PoE (connects to)
APC Smart-UPS 1500, hardware, 10.0.10.30, healthy
- from USW Pro 24 PoE (connects to)
- from pve1 (depends on)
- from pve2 (depends on)
- from pve3 (depends on)
- from TrueNAS Scale (depends on)
- from NUT exporter (uses)
Management · VLAN 10, network, 10.0.10.0/24, healthy
- from Dream Machine Pro (routes)
Servers · VLAN 20, network, 10.0.20.0/24, healthy
- from Dream Machine Pro (routes)
IoT · VLAN 30, network, 10.0.30.0/24, healthy
- from Dream Machine Pro (routes)
Proxmox cluster, cluster, healthy
- cluster member pve1
- cluster member pve2
- cluster member pve3
pve1, hardware, 10.0.20.11, healthy
- connects to pve2
- hosts docker-01 · VM
- hosts adguard · LXC
- depends on APC Smart-UPS 1500
- from USW Aggregation (connects to)
- from Proxmox cluster (cluster member)
pve2, hardware, 10.0.20.12, healthy
- connects to pve3
- hosts docker-02 · VM
- hosts haos · VM
- depends on APC Smart-UPS 1500
- from USW Aggregation (connects to)
- from pve1 (connects to)
- from Proxmox cluster (cluster member)
pve3, hardware, 10.0.20.13, healthy
- hosts k3s · VM
- hosts pbs · LXC
- depends on APC Smart-UPS 1500
- from USW Aggregation (connects to)
- from pve2 (connects to)
- from Proxmox cluster (cluster member)
Dell R730, hardware, 10.0.20.20, healthy
- hosts ollama · VM
- from iDRAC 8 (connects to)
- from USW Aggregation (connects to)
iDRAC 8, misc, 10.0.10.20, healthy
- connects to Dell R730
- from USW Pro 24 PoE (connects to)
TrueNAS Scale, hardware, 10.0.20.30, healthy
- has storage tank · 48 TB
- has storage fast · 4 TB NVMe
- depends on APC Smart-UPS 1500
- from USW Aggregation (connects to)
tank · 48 TB, storage, healthy
- from TrueNAS Scale (has storage)
- from Jellyfin (depends on)
- from Nextcloud (depends on)
- from Sonarr (depends on)
- from Radarr (depends on)
- from Proxmox Backup (uses)
fast · 4 TB NVMe, storage, healthy
- from TrueNAS Scale (has storage)
- from ollama · VM (depends on)
Raspberry Pi 4, hardware, 10.0.30.40, healthy
- from U6 Pro · Living room (connects to)
- from Home Assistant (depends on)
docker-01 · VM, compute, 10.0.20.101, healthy
- runs proxy
- from pve1 (hosts)
adguard · LXC, compute, 10.0.20.53, healthy
- runs AdGuard Home
- from pve1 (hosts)
docker-02 · VM, compute, 10.0.20.102, healthy
- runs monitoring
- from pve2 (hosts)
haos · VM, compute, 10.0.30.10, healthy
- runs Home Assistant
- from pve2 (hosts)
k3s · VM, compute, 10.0.20.110, healthy
- runs Forgejo
- from pve3 (hosts)
pbs · LXC, compute, 10.0.20.60, healthy
- runs Proxmox Backup
- from pve3 (hosts)
ollama · VM, compute, 10.0.20.120, healthy
- depends on fast · 4 TB NVMe
- from Dell R730 (hosts)
AdGuard Home, service, healthy
- from adguard · LXC (runs)
Home Assistant, service, healthy
- depends on Raspberry Pi 4
- from haos · VM (runs)
Proxmox Backup, service, healthy
- uses tank · 48 TB
- from pbs · LXC (runs)
Forgejo, service, healthy
- from k3s · VM (runs)
proxy, docker network, healthy
- on network Jellyfin
- on network Sonarr
- on network Radarr
- on network Nextcloud
- on network authentik
- on network Portainer
- from docker-01 · VM (runs)
monitoring, docker network, healthy
- on network Grafana
- on network Prometheus
- on network NUT exporter
- on network Uptime Kuma
- from docker-02 · VM (runs)
Jellyfin, docker container, healthy
- depends on tank · 48 TB
- from proxy (on network)
Sonarr, docker container, healthy
- depends on tank · 48 TB
- from proxy (on network)
Radarr, docker container, healthy
- depends on tank · 48 TB
- from proxy (on network)
Nextcloud, docker container, healthy
- depends on tank · 48 TB
- from proxy (on network)
authentik, docker container, healthy
- from proxy (on network)
Portainer, docker container, healthy
- from proxy (on network)
Grafana, docker container, healthy
- depends on Prometheus
- from monitoring (on network)
Prometheus, docker container, healthy
- from monitoring (on network)
- from Grafana (depends on)
NUT exporter, docker container, healthy
- uses APC Smart-UPS 1500
- from monitoring (on network)
Uptime Kuma, docker container, healthy
- from monitoring (on network)

View: Dagre / dependencies
Devices: 44
Links: 61
Degraded: 0
Down: 0
Try it: Sample homelab running live. Choose a device to interrupt.

02 / How it works

Discovered,not drawn.

Point it at a subnet or a Proxmox cluster. Devices appear as they're found, with their links, then everything running on them.

Alive,in real time.

Health, load and link speed, live. Take something down and watch what goes with it.

Ten waysto see it.

The same graph, rearranged: by dependency, by network, by rack, by what runs on what.

Found: 44
Links: —
Degraded: 0
Down: 0
Status: 44 devices

03 / Ecosystem

Speaks yourhardware.

Pulls live state from what you already run. Nothing to redraw.

Proxmox VE
API
Nodes, VMs, LXCs, storage
Docs for Proxmox VE →
Dell iDRAC · HPE iLO
SNMP · Redfish
Temperatures, power, fans
Docs for Dell iDRAC · HPE iLO →
Switches, routers, PDUs
SNMP
Ports, links, throughput
Docs for Switches, routers, PDUs →
APC UPS
SNMP
Battery, load, runtime
Docs for APC UPS →
Docker
Docker API
Containers, networks, hosts
Docs for Docker →
Uptime Kuma
Socket.IO
Service health
Docs for Uptime Kuma →

…and anything that answers on your network: nmap and ARP discovery, plus ICMP, HTTP and TCP probes.

Puts the right logo on your devices, from a library of 111.

04 / Trust

Built likeinfrastructure.

Security you'd expect from the tools you run it next to.

How releases are verified →

Access control
Roles, TOTP multi-factor and OAuth/OIDC sign-in.
Docs for Access control →
Encrypted secrets
Credentials live in an encrypted vault, never in plain config.
Docs for Encrypted secrets →
Tamper-evident audit log
Every change is recorded in a SHA-256 hash chain.
Docs for Tamper-evident audit log →
Least privilege
Application processes run as an unprivileged user.
Docs for Least privilege →
Signed releases
Cosign-signed images, SBOMs and SHA256SUMS on every release.
Verify for Signed releases →
Threat model
What it defends against, and what it deliberately doesn't.
Docs for Threat model →

05 / What's new

What'snew.

From the releases and the project's announcements.

All releases →All news →

Latest releaseStableSep 30, 2026

v0.4.6

Circuit Breaker v0.4.6 · Release notes →

Aug 10, 2026
AnnouncementCircuit Breaker 1.0.0 Sprint Begins Thursday 🚀
Aug 5, 2026
AnnouncementCircuit Breaker Agents Incoming!

06 / Install

Running inthree minutes.

Self-hosted on your own Linux server. Pick how you run it, then paste one command.

Installs v0.4.6 · stable

All downloads →

NativeNativeProxmox LXCProxmoxDockerDocker

$ curl -fsSL https://raw.githubusercontent.com/BlkLeg/CircuitBreaker/main/install.sh | sudo bash

Installs natively with systemd on the Linux machine that will host it. No Docker needed. Native guide →

$ bash -c "$(curl -fsSL https://raw.githubusercontent.com/BlkLeg/CircuitBreaker/main/cb-proxmox-deploy.sh)"

Run on your Proxmox VE host to create a Debian container with Circuit Breaker inside. This one tracks the app's main branch: read the script before you run it. Proxmox LXC guide →

$ curl -fsSL https://raw.githubusercontent.com/BlkLeg/CircuitBreaker/main/install.sh | bash -s -- --docker

The same installer, set up as a Compose project with the all-in-one image. Docker guide →

Every box. Every link.

How it works

Discovered,not drawn.

Alive,in real time.

Ten waysto see it.

Speaks yourhardware.

Proxmox VE

Dell iDRAC · HPE iLO

Switches, routers, PDUs

APC UPS

Docker

Uptime Kuma

Built likeinfrastructure.

Access control

Encrypted secrets

Tamper-evident audit log

Least privilege

Signed releases

Threat model

What'snew.

Running inthree minutes.