SwitchMgr

Network device management and orchestration — switches, console servers, PDUs and config backup.

IN DEV Infrastructure & Ops · 7 features · PHP 8.4 / CI4.7 · Go agent · MariaDB

overview

SwitchMgr is a self-hosted control plane for network devices: switches, IP-KVM console servers and PDUs behind one panel plus a Go site agent.

The panel never opens a socket to a device — all device I/O goes through the agent as typed, validated ops. Credentials stay agent-local (creds_ref → env vars), never in the database.

features

  • ▸Typed ops only — no generic exec anywhere in the chain
  • ▸Agent enrolment — one-shot tokens → persistent X-Agent-Key, atomic op claiming
  • ▸Device credentials agent-local — panel stores references, not secrets
  • ▸Scoped sm_ API keys, hash-chained audit log, task queue
  • ▸Console servers and PDUs alongside switches — power and out-of-band access
  • ▸Built-in config backup — versioning, normalized-hash dedup, diffs and golden/drift (ConfigVault engine, ported in)
  • ▸Self-hosted per org — one panel, many fleets

stack

PHP 8.4 / CI4.7 Go agent MariaDB

get started

quickstart
$ composer install && cp env .env
$ php spark migrate && php spark switchmgr:seed
$ php spark serve --host 0.0.0.0 --port 9030
▊