Self-hosted Docker app for documenting homelab and lab infrastructure: racks, devices, ports, cables, IPAM, VLANs, Wi-Fi, monitoring and topology maps.
- Stars
- 21,854
- Forks
- 3,188
- Open issues
- 225
- Last commit
- 20 hours ago
What is it?
NetBox is a web application for modeling and documenting network infrastructure. It covers racks, devices, cables, IP addresses, VLANs, circuits, power and VPNs, and stores them in a single data model so that network teams have one authoritative inventory. NetBox does not configure network devices itself; it holds the intended state and exposes it through programmable APIs for provisioning, monitoring and assurance tools.
Beyond the core data model, NetBox supports custom fields and tags, a granular permission system, custom validation rules, and change logging that records who changed what. It can render Jinja2 configuration templates from its own data, run custom scripts from the UI, and trigger webhooks or scripts on events. Functionality can be extended through plugins, with examples such as branching, DNS and BGP management.
Key features
- 01Pre-built data model for racks, devices, cables, IP addresses, VLANs and circuits
- 02REST and GraphQL APIs for integration with automation tools
- 03Custom fields, tags and custom validation rules
- 04Granular role-based permissions
- 05Jinja2 configuration template rendering from device data
- 06Change logging with user attribution and event-triggered webhooks
Use cases
- Documenting data center racks, cabling and device inventory
- Maintaining IP address management (IPAM) and VLAN records
- Serving as the source of truth for Ansible or Salt provisioning workflows
- Generating device configurations from templated data
Things to know
- NetBox does not interact with network devices directly, so it models intended state and needs separate automation tools to apply changes.
Topics
FAQ
- What is netbox?
- Open-source source-of-truth web application for modeling and documenting network infrastructure, with a REST and GraphQL API for automation. NetBox is a web application for modeling and documenting network infrastructure. It covers racks, devices, cables, IP addresses, VLANs, circuits, power and VPNs, and stores them in a single data model so that network teams have one authoritative inventory. NetBox does not configure network devices itself; it holds the intended state and exposes it through programmable APIs for provisioning, monitoring and assurance tools.
- Is netbox free to use? What license does it have?
- netbox is open source under the Apache-2.0 license. Check the license terms before using it in commercial products.
- Is netbox still maintained?
- Actively maintained. The last commit to netbox was on Nov 6, 2026.
- What can I use netbox for?
- Documenting data center racks, cabling and device inventory Maintaining IP address management (IPAM) and VLAN records Serving as the source of truth for Ansible or Salt provisioning workflows Generating device configurations from templated data
- Where can I get netbox?
- The source code and installation instructions are on GitHub: https://github.com/netbox-community/netbox
Summary generated by AI from the project's README. GitHub stats refresh daily.
Related projects
Self-hosted network visibility tool that continuously discovers devices on your networks, flags changes, and sends alerts.
Python library that simplifies SSH CLI connections to multi-vendor network devices, for sending show commands and config changes.
Drag-and-drop web tool for planning and documenting server, network and AV equipment layouts in a 42U rack.
A Go network platform and proxy core supporting protocols such as VLESS, VMess, Trojan, Shadowsocks, WireGuard, and REALITY.
A self-hosted, browser-based internet speed test written in JavaScript, measuring download, upload, ping and jitter.