1
0
mirror of https://github.com/netbox-community/netbox.git synced 2024-05-10 07:54:54 +00:00

65 lines
3.0 KiB
Markdown
Raw Normal View History

2019-12-29 14:10:31 +00:00
![NetBox](docs/netbox_logo.svg "NetBox logo")
2016-06-27 16:48:54 -04:00
NetBox is an IP address management (IPAM) and data center infrastructure
management (DCIM) tool. Initially conceived by the network engineering team at
[DigitalOcean](https://www.digitalocean.com/), 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.
2016-03-01 11:23:03 -05:00
NetBox runs as a web application atop the [Django](https://www.djangoproject.com/)
Python framework with a [PostgreSQL](https://www.postgresql.org/) database. For a
complete list of requirements, see `requirements.txt`. The code is available [on GitHub](https://github.com/netbox-community/netbox).
2016-06-17 16:17:55 -04:00
The complete documentation for NetBox can be found at [Read the Docs](https://netbox.readthedocs.io/en/stable/). A public demo instance is available at https://demo.netbox.dev.
### Discussion
* [GitHub Discussions](https://github.com/netbox-community/netbox/discussions) - Discussion forum hosted by GitHub; ideal for Q&A and other structured discussions
2021-03-15 14:45:53 -04:00
* [Slack](https://slack.netbox.dev/) - Real-time chat hosted by the NetDev Community; best for unstructured discussion or just hanging out
* [Google Group](https://groups.google.com/g/netbox-discuss) - Legacy mailing list; slowly being replaced by GitHub discussions
### Build Status
2021-04-23 11:52:42 -07:00
| | status |
| ----------- | ------------------------------------------------------------------------------------------------- |
| **master** | ![Build status](https://github.com/netbox-community/netbox/workflows/CI/badge.svg?branch=master) |
| **develop** | ![Build status](https://github.com/netbox-community/netbox/workflows/CI/badge.svg?branch=develop) |
2020-03-05 08:51:03 -05:00
### Screenshots
2021-04-26 01:15:37 -07:00
![Screenshot of Main Page](docs/media/home-light.png "Main Page")
2016-06-27 11:43:33 -04:00
2020-02-24 15:22:33 +00:00
---
2021-04-26 01:15:37 -07:00
![Screenshot of Rack Elevation](docs/media/rack-dark.png "Rack Elevation")
2016-06-27 11:43:33 -04:00
2020-02-24 15:22:33 +00:00
---
2021-04-26 01:15:37 -07:00
![Screenshot of Prefix Hierarchy](docs/media/prefixes-light.png "Prefix Hierarchy")
2021-04-23 11:52:42 -07:00
---
2021-04-26 01:15:37 -07:00
![Screenshot of Cable Tracing](docs/media/cable-dark.png "Cable Tracing")
2016-06-27 11:43:33 -04:00
2020-03-05 08:51:03 -05:00
## Installation
2016-06-17 16:17:55 -04:00
Please see [the documentation](https://netbox.readthedocs.io/en/stable/) for
instructions on installing NetBox. To upgrade NetBox, please download the
[latest release](https://github.com/netbox-community/netbox/releases) and
run `upgrade.sh`.
2016-03-01 11:23:03 -05:00
2020-03-05 08:51:03 -05:00
## Providing Feedback
The best platform for general feedback, assistance, and other discussion is our
[GitHub discussions](https://github.com/netbox-community/netbox/discussions).
To report a bug or request a specific feature, please open a GitHub issue using
the [appropriate template](https://github.com/netbox-community/netbox/issues/new/choose).
If you are interested in contributing to the development of NetBox, please read
our [contributing guide](CONTRIBUTING.md) prior to beginning any work.
2020-03-05 08:51:03 -05:00
## Related projects
Please see [our wiki](https://github.com/netbox-community/netbox/wiki/Community-Contributions)
for a list of relevant community projects.