Skip to content

HOWTO: Deploy NetBox as the Authoritative Platform Record

The authoritative on-prem reference scenario uses NetBox for declared device, prefix, VLAN, and site state. This HOWTO deploys that authority through platform/onprem/bootstrap-netbox, seeds the data model aligned with ADR-0002 and ADR-0101, and wires its structured output into the Ansible and Nornir inventory-export path. The lifecycle module carries the same contract into day-2 operations.

What this covers:

  • NetBox deployment via platform/onprem/bootstrap-netbox@v1 with PostgreSQL backend and Redis
  • Initial data seeding: sites, VLANs, prefixes, and device roles aligned with ADR-0101
  • API token provisioning and inventory export pipeline wiring for Ansible and Nornir

Learn this in Academy: Platform Services track