Mascali
/
netbox
mirror of https://github.com/netbox-community/netbox.git
1
0
Fork 0
Code Issues Packages Projects Releases Wiki Activity
The premier source of truth powering network automation. Open source under Apache 2. Public demo: https://demo.netbox.dev
9,210 Commits 16 Branches 298 Tags 135 MiB
Python 94.1%
HTML 4.8%
TypeScript 0.9%
SCSS 0.1%
Go to file
jeremystretch b40afd1006 Create custom RTD configuration 2022-02-11 14:49:45 -05:00
.github Merge branch 'develop' into feature 2022-02-10 15:05:54 -05:00
contrib Fixes #8512: Correct file permissions to allow execution of housekeeping script 2022-02-01 16:58:09 -05:00
docs Use project requirements to build docs 2022-02-11 14:36:03 -05:00
netbox Standardize on get_FOO_color() method for returning ChoiceField colors 2022-02-11 14:25:13 -05:00
scripts Allow bypassing the pre-commit script with NOVALIDATE=1 2021-11-05 13:40:38 -04:00
.gitattributes Treat compiled JS/CSS as binary when diffing 2021-09-16 11:03:55 -04:00
.gitignore Closes #8210: Establish netbox/local/ as a path for local resources 2022-01-03 09:45:30 -05:00
.readthedocs.yaml Create custom RTD configuration 2022-02-11 14:49:45 -05:00
CHANGELOG.md Reorganized CHANGELOG into release notes based on minor version number 2019-10-09 13:54:05 -04:00
CONTRIBUTING.md Remove references to the old mailing list 2022-02-10 14:56:21 -05:00
LICENSE.txt Initial push to public repo 2016-03-01 11:23:03 -05:00
NOTICE Create NOTICE file 2019-06-25 13:59:00 -04:00
README.md Remove references to the old mailing list 2022-02-10 14:56:21 -05:00
base_requirements.txt Merge v3.1.7 2022-02-03 12:55:34 -05:00
mkdocs.yml Create custom RTD configuration 2022-02-11 14:49:45 -05:00
requirements.txt Pull graphene-django from v2 branch 2022-02-07 11:32:02 -05:00
upgrade.sh Closes #7319: Remove migrations check from upgrade.sh to avoid misleading error messages 2021-10-01 08:57:17 -04:00

README.md

NetBox logo

Master branch build status

NetBox is an infrastructure resource modeling (IRM) tool designed to empower network automation, used by thousands of organizations around the world. Initially conceived by the network engineering team at DigitalOcean, NetBox was developed specifically to address the needs of network and infrastructure engineers. It is intended to function as a domain-specific source of truth for network operations.

Myriad infrastructure components can be modeled in NetBox, including:

  • Hierarchical regions, site groups, sites, and locations
  • Racks, devices, and device components
  • Cables and wireless connections
  • Power distribution
  • Data circuits and providers
  • Virtual machines and clusters
  • IP prefixes, ranges, and addresses
  • VRFs and route targets
  • FHRP groups (VRRP, HSRP, etc.)
  • AS numbers
  • VLANs and scoped VLAN groups
  • Organizational tenants and contacts

In addition to its extensive built-in models and functionality, NetBox can be customized and extended through the use of:

  • Custom fields
  • Custom links
  • Configuration contexts
  • Custom model validation rules
  • Reports
  • Custom scripts
  • Export templates
  • Conditional webhooks
  • Plugins
  • Single sign-on (SSO) authentication
  • NAPALM integration
  • Detailed change logging

NetBox also features a complete REST API as well as a GraphQL API for easily integrating with other tools and systems.

NetBox runs as a web application atop the Django Python framework with a PostgreSQL database. For a complete list of requirements, see requirements.txt. The code is available on GitHub.

The complete documentation for NetBox can be found at Read the Docs. A public demo instance is available at https://demo.netbox.dev.

Thank you to our sponsors!

DigitalOcean            Equinix Metal            NS1
Stellar Technologies

Discussion

  • GitHub Discussions - Discussion forum hosted by GitHub; ideal for Q&A and other structured discussions
  • Slack - Real-time chat hosted by the NetDev Community; best for unstructured discussion or just hanging out

Installation

Please see the documentation for instructions on installing NetBox. To upgrade NetBox, please download the latest release and run upgrade.sh.

Providing Feedback

The best platform for general feedback, assistance, and other discussion is our GitHub discussions. To report a bug or request a specific feature, please open a GitHub issue using the appropriate template.

If you are interested in contributing to the development of NetBox, please read our contributing guide prior to beginning any work.

Screenshots

Screenshot of main page (light mode)

Screenshot of main page (dark mode)

Screenshot of rack elevation

Screenshot of prefixes hierarchy

Screenshot of cable trace

Related projects

Please see our wiki for a list of relevant community projects.