Circuit Breaker

Map engine readyLocal-first / open source

Search, pin and jump anywhere on the Circuit Breaker site.

Pinned
Use a pin button to keep pages here.
Theme
Mode

Release

v0.2.2

StableView on GitHub

Downloads

This release published no files; its source is on GitHub.

From the GitHub release

GitHub Release v0.2.2: v0.2.2 — Discovery Engine & Proxmox Integration Homelab topology, now self-aware. This release ships the biggest feature Circuit Breaker has ever seen: a full auto-discovery engine that actively scans your network, talks to your infrastructure, and maps it — without you drawing a single line. 🔍 Auto-Discovery Engine Circuit Breaker can now find what’s on your network automatically. New Scan wizard with three modes: Safe — Ping + TCP connect. No elevated privileges required ( CAP_NET_RAW -free) Full — ARP sweep + nmap OS fingerprint for deep device identification (requires NET_RAW ) Docker — Enumerates containers directly from the Docker socket Target Scope — Scan a single CIDR ( 192.168.1.0/24 ) or multiple VLANs in one pass (up to 10 networks) Scan Types — SNMP and HTTP probing run in parallel per host Scan Profiles — Save and reuse named scan configurations Scan History — Full log of past jobs with timestamps, discovered counts, and status Scan Settings — Global discovery behavior controls (timeouts, concurrency, ports) Review Queue — Discovered nodes land here first. Accept, reject, tag as Cluster or Stack before they hit the topology map. Bulk Accept All / Reject All supported Live Listeners (opt-in) — Passive capture mode that watches for new devices as they appear. Enable in Settings → Discovery 🖥️ Proxmox VE Integration Connect your Proxmox clusters and let Circuit Breaker do the rest. Add clusters via Settings → Discovery → Proxmox VE → Add Cluster Connection testing — validates API token and TLS before saving One-click Discover — syncs nodes, VMs, and LXC containers into the topology Displays per-cluster summary: node count, VM count, CT count, last sync timestamp Cluster status badge: 🟢 Connected / 🔴 Unreachable Edit and delete cluster configurations without losing discovered nodes Idempotent sync — running Discover twice never creates duplicate nodes 🐳 Docker Discovery Discover Docker shortcut in the sidebar — instant enumeration of running containers from the local Docker socket Containers map to service nodes with name, image, ports, and network memberships Works alongside network scans or standalone 🏗️ Infrastructure & Deployment Non-root container — app now runs as breaker:1000 (uid 1000). Root filesystem is read-only. Only /data and /tmp are writable. Resolves permission denied errors on volume mounts Standardized deployment — single docker-compose.yml is now the canonical artifact for all install paths (one-liner, manual, local dev). No more divergent compose files Unified install script — install.sh downloads the compose file, auto-generates secrets, and starts the stack. Re-running is fully idempotent Postgres replaces SQLite as the primary database for production deployments Memory and disk usage indicators added to the app footer (live, no refresh needed) 🔧 Fixes Map node IDs are now stable across requests — renaming a device no longer breaks topology edges Proxmox sync is idempotent — double sync no longer creates ghost nodes All edges validated before render — orphaned edges (pointing to deleted nodes) are filtered server-side Docker volume ownership corrected — resolves startup failures after upgrades from earlier versions ⚙️ Install / Upgrade Fresh install: bash curl -fsSL https://raw.githubusercontent.com/BlkLeg/CircuitBreaker/main/install.sh | bash Upgrade existing install: bash docker compose pull && docker compose up -d Fix volume permissions (if upgrading from a root-run instance): bash docker run –rm -v circuitbreaker-data:/data alpine \ sh -c "chown -R 1000:1000 /data" docker compose up -d 📦 Docker Images Tag | Description – | – ghcr.io/blkleg/circuitbreaker:v0.2.2 | This release ghcr.io/blkleg/circuitbreaker:latest | Always points to latest stable

Multi-arch: linux/amd64 · linux/arm64 🔜 Up Next (v0.3.0) Live telemetry pipeline — SNMP/IPMI polling with real-time map badges TrueNAS & UniFi integrations Advanced topology: VLAN overlays, WireGuard tunnels User invite system and RBAC (admin / editor / viewer) Built for homelabs that have outgrown spreadsheets. GitHub · Issues · Discussions Here’s a polished GitHub release for v0.2.2:

v0.2.2 — Discovery Engine & Proxmox Integration

Homelab topology, now self-aware.

This release ships the biggest feature Circuit Breaker has ever seen: a full auto-discovery engine that actively scans your network, talks to your infrastructure, and maps it — without you drawing a single line.

🔍 Auto-Discovery Engine

Circuit Breaker can now find what’s on your network automatically.

  • New Scan wizard with three modes:
    • Safe — Ping + TCP connect. No elevated privileges required (CAP_NET_RAW-free)
    • Full — ARP sweep + nmap OS fingerprint for deep device identification (requires NET_RAW)
    • Docker — Enumerates containers directly from the Docker socket
  • Target Scope — Scan a single CIDR (192.168.1.0/24) or multiple VLANs in one pass (up to 10 networks)
  • Scan Types — SNMP and HTTP probing run in parallel per host
  • Scan Profiles — Save and reuse named scan configurations
  • Scan History — Full log of past jobs with timestamps, discovered counts, and status
  • Scan Settings — Global discovery behavior controls (timeouts, concurrency, ports)
  • Review Queue — Discovered nodes land here first. Accept, reject, tag as Cluster or Stack before they hit the topology map. Bulk Accept All / Reject All supported
  • Live Listeners (opt-in) — Passive capture mode that watches for new devices as they appear. Enable in Settings → Discovery

🖥️ Proxmox VE Integration

Connect your Proxmox clusters and let Circuit Breaker do the rest.

  • Add clusters via Settings → Discovery → Proxmox VE → Add Cluster
  • Connection testing — validates API token and TLS before saving
  • One-click Discover — syncs nodes, VMs, and LXC containers into the topology
  • Displays per-cluster summary: node count, VM count, CT count, last sync timestamp
  • Cluster status badge: 🟢 Connected / 🔴 Unreachable
  • Edit and delete cluster configurations without losing discovered nodes
  • Idempotent sync — running Discover twice never creates duplicate nodes

🐳 Docker Discovery

  • Discover Docker shortcut in the sidebar — instant enumeration of running containers from the local Docker socket
  • Containers map to service nodes with name, image, ports, and network memberships
  • Works alongside network scans or standalone

🏗️ Infrastructure & Deployment

  • Non-root container — app now runs as breaker:1000 (uid 1000). Root filesystem is read-only. Only /data and /tmp are writable. Resolves permission denied errors on volume mounts
  • Standardized deployment — single docker-compose.yml is now the canonical artifact for all install paths (one-liner, manual, local dev). No more divergent compose files
  • Unified install script — install.sh downloads the compose file, auto-generates secrets, and starts the stack. Re-running is fully idempotent
  • Postgres replaces SQLite as the primary database for production deployments
  • Memory and disk usage indicators added to the app footer (live, no refresh needed)

🔧 Fixes

  • Map node IDs are now stable across requests — renaming a device no longer breaks topology edges
  • Proxmox sync is idempotent — double sync no longer creates ghost nodes
  • All edges validated before render — orphaned edges (pointing to deleted nodes) are filtered server-side
  • Docker volume ownership corrected — resolves startup failures after upgrades from earlier versions

⚙️ Install / Upgrade

Fresh install:

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

Upgrade existing install:

docker compose pull && docker compose up -d

Fix volume permissions (if upgrading from a root-run instance):

docker run --rm -v circuitbreaker-data:/data alpine \
  sh -c "chown -R 1000:1000 /data"
docker compose up -d

📦 Docker Images

Tag Description
ghcr.io/blkleg/circuitbreaker:v0.2.2 This release
ghcr.io/blkleg/circuitbreaker:latest Always points to latest stable

Multi-arch: linux/amd64 · linux/arm64

🔜 Up Next (v0.3.0)

  • Live telemetry pipeline — SNMP/IPMI polling with real-time map badges
  • TrueNAS & UniFi integrations
  • Advanced topology: VLAN overlays, WireGuard tunnels
  • User invite system and RBAC (admin / editor / viewer)

Built for homelabs that have outgrown spreadsheets. [GitHub](https://github.com/BlkLeg/CircuitBreaker) · [Issues](https://github.com/BlkLeg/CircuitBreaker/issues) · [Discussions](https://github.com/BlkLeg/CircuitBreaker/discussions)