• Stars
    star
    1,800
  • Rank 25,807 (Top 0.6 %)
  • Language
    Python
  • License
    Apache License 2.0
  • Created over 7 years ago
  • Updated 2 months ago

Reviews

There are no reviews yet. Be the first to send feedback to the community and the maintainers!

Repository Details

๐Ÿณ Docker Image of NetBox

netbox-docker

GitHub release (latest by date) GitHub stars GitHub closed pull requests Github release workflow Docker Pulls GitHub license

The GitHub repository houses the components needed to build NetBox as a container. Images are built regularly using the code in that repository and are pushed to Docker Hub, Quay.io and GitHub Container Registry.

Do you have any questions? Before opening an issue on Github, please join our Slack and ask for help in the #netbox-docker channel.

Quickstart

To get NetBox Docker up and running run the following commands. There is a more complete Getting Started guide on our wiki which explains every step.

git clone -b release https://github.com/netbox-community/netbox-docker.git
cd netbox-docker
tee docker-compose.override.yml <<EOF
version: '3.4'
services:
  netbox:
    ports:
      - 8000:8080
EOF
docker compose pull
docker compose up

The whole application will be available after a few minutes. Open the URL http://0.0.0.0:8000/ in a web-browser. You should see the NetBox homepage.

To create the first admin user run this command:

docker compose exec netbox /opt/netbox/netbox/manage.py createsuperuser

If you need to restart Netbox from an empty database often, you can also set the SUPERUSER_* variables in your docker-compose.override.yml as shown in the example.

Container Image Tags

New container images are built and published automatically every ~24h.

We recommend to use either the vX.Y.Z-a.b.c tags or the vX.Y-a.b.c tags in production!

  • vX.Y.Z-a.b.c, vX.Y-a.b.c: These are release builds containing NetBox version vX.Y.Z. They contain the support files of NetBox Docker version a.b.c. You must use NetBox Docker version a.b.c to guarantee the compatibility. These images are automatically built from the corresponding releases of NetBox.
  • latest-a.b.c: These are release builds, containing the latest stable version of NetBox. They contain the support files of NetBox Docker version a.b.c. You must use NetBox Docker version a.b.c to guarantee the compatibility. These images are automatically built from the master branch of NetBox.
  • snapshot-a.b.c: These are prerelease builds. They contain the support files of NetBox Docker version a.b.c. You must use NetBox Docker version a.b.c to guarantee the compatibility. These images are automatically built from the develop branch of NetBox.

For each of the above tag, there is an extra tag:

  • vX.Y.Z, vX.Y: This is the same version as vX.Y.Z-a.b.c (or vX.Y-a.b.c, respectively). It always points to the latest version of NetBox Docker.
  • latest This is the same version as latest-a.b.c. It always points to the latest version of NetBox Docker.
  • snapshot This is the same version as snapshot-a.b.c. It always points to the latest version of NetBox Docker.

Documentation

Please refer to our wiki on GitHub for further information on how to use the NetBox Docker image properly. The wiki covers advanced topics such as using files for secrets, configuring TLS, deployment to Kubernetes, monitoring and configuring LDAP.

Our wiki is a community effort. Feel free to correct errors, update outdated information or provide additional guides and insights.

Getting Help

Feel free to ask questions in our GitHub Community or join our Slack and ask in our channel #netbox-docker, which is free to use and where there are almost always people online that can help you in the Slack channel.

If you need help with using NetBox or developing for it or against it's API you may find the #netbox channel on the same Slack instance very helpful.

Dependencies

This project relies only on Docker and docker-compose meeting these requirements:

  • The Docker version must be at least 20.10.10.
  • The containerd version must be at least 1.5.6.
  • The docker-compose version must be at least 1.28.0.

To check the version installed on your system run docker --version and docker compose version.

Updating

Please read the release notes carefully when updating to a new image version. Note that the version of the NetBox Docker container image must stay in sync with the code.

If you update for the first time, be sure to follow our How To Update NetBox Docker guide in the wiki.

Rebuilding the Image

./build.sh can be used to rebuild the container image. See ./build.sh --help for more information.

For more details on custom builds consult our wiki.

Tests

We have a test script. It runs NetBox's own unit tests and ensures that all initializers work:

IMAGE=netboxcommunity/netbox:latest ./test.sh

Support

This repository is currently maintained by the community. Please consider sponsoring the maintainers of this project.

More Repositories

1

netbox

The premier source of truth powering network automation. Open source under Apache 2. Try NetBox Cloud free: https://netboxlabs.com/free-netbox-cloud/
Python
15,828
star
2

devicetype-library

A collection of community-sourced DeviceType definitions for import to NetBox
Python
899
star
3

netbox-topology-views

A netbox plugin that draws topology views
Python
753
star
4

pynetbox

Python API client library for Netbox.
Python
563
star
5

ansible_modules

NetBox modules for Ansible using Ansible Collections
Python
327
star
6

Device-Type-Library-Import

This library is intended to assist with importing device and module types into NetBox from the NetBox Community DeviceType-Library
Python
262
star
7

netbox-chart

A Helm chart for NetBox
Mustache
247
star
8

netbox-bgp

NetBox plugin for BGP related objects documentation
Python
242
star
9

customizations

A collection of community submitted and maintained customizations including reports, scripts, validators and export templates
Python
205
star
10

netbox-qrcode

NetBox Plugin for generate QR Codes
Python
201
star
11

go-netbox

The official Go API client for Netbox IPAM and DCIM service.
Shell
197
star
12

awesome-netbox

A curated list of awesome NetBox resources
186
star
13

netbox-zero-to-hero

A short course designed to take new NetBox users from โ€˜Zero to Heroโ€™.
Python
149
star
14

netbox-plugin-tutorial

A tutorial on building custom plugins for NetBox v3.2+
89
star
15

netbox-acls

A NetBox plugin for Access Lists based off of the NetBox Plugin Demo
Python
86
star
16

netbox-napalm-plugin

NetBox Napalm plugin
JavaScript
49
star
17

netbox-reorder-rack

NetBox plugin to allow users to reorder devices within a rack using a drag and drop UI.
Python
45
star
18

netbox-python

Python NetBox API Client
Python
37
star
19

netbox-operator

[INCUBATING] A Kubernetes operator to manage NetBox resources directly through Kubernetes.
Go
33
star
20

cookiecutter-netbox-plugin

Cookiecutter template for easy building NetBox plugins
Python
22
star
21

netbox-healthcheck-plugin

HTML
20
star
22

netbox-demo-data

Demo data useful for populating demo instances of NetBox
19
star
23

migration-scripts

Python
10
star
24

netbox-plugin-demo

Python
7
star
25

netbox.dev-old

netbox.dev website
HTML
1
star
26

netbox-demo

A plugin for NetBox demo instances
Python
1
star