Setup Network, System, and Datacenter Documentation Server.

Everything Linux, A.I, IT News, DataOps, Open Source and more delivered right to you.
"The best Linux newsletter on the web"

This post is about Setup Network, System, and Datacenter Documentation Server.

Management of your infrastructure documentation is not an easy job. An application is designed to keep 80% of infrastructure documentation called NET BOX. Being a System Network guy, I always wondered about such an app/server that could manage my infrastructure documentation. Let me tell you more about this application.

What is NETBOX?

This application mainly documents network data center modules, e.g., Racks, servers management, and power sources. It is an open-source application developed specifically to address the need to document the infrastructure. This made it easy to search and interact with the devices, racks, and sites in an immense infrastructure. You can view complete information about devices, links, power sources, and other information. It encompasses the following aspects of network management.

  • IP address management (IPAM): IP networks and addresses, VRFs, and VLANs.
  • Equipment racks: Organized by group and site.
  • Devices: Servers, Routers, Switches, and other system network devices
  • Power resources and calculations.
  • Connections: detailed links and connections between devices.
  • Virtualization: Virtual Machines and clusters
  • Data Circuits: Long-haul communication circuits and providers.

The following features/services are not covered by netbox

  • Network monitoring
  • DNS server
  • RADIUS server
  • Configuration management
  • Facilities management

Application Stack

NetBox is built on the Django Python framework and utilizes a PostgreSQL database. It runs as a WSGI service behind your choice of HTTP server.

HTTP servicenginx or Apache
WSGI servicegunicorn or uWSGI
DatabasePostgreSQL 10+
Task queuingRedis/Django-rq
Live device accessNAPALM (optional)
Setup Network, System, and Datacenter Documentation Server.


  1. Ubuntu 20.04
  2. PostgresSQL | Version 10+
  3. Redis | Version 4.0 +
  4. Python | version 3.7 +

Steps to Install NETBOX

Step 1: Prepare and Update Machine

Update the OS

sudo apt-get update
Install PostgreSQL
sudo apt install -y postgresql
Start the PostgreSQL and enable
systemctl start postgresql 
systemctl enable postgresql
check the version by running the following command
psql -V
Create Database, user, set privileges of user on DB
login to DB terminal
sudo -u postgres psql

pass the following command in the terminal to create DB and user

CREATE USER netbox WITH PASSWORD 'netbox123';

Step 2: Install the Redis server

apt install -y redis-server
verify Redis service by using the following command.
redis-cli ping

Step 3: Install NETBOX

Create a directory for netbox

sudo mkdir -p /opt/netbox/
cd /opt/netbox/
Install git to clone the netbox GitHub repository
apt install -y git 

sudo git clone -b master –depth 1 .

Create the NetBox System User

Create a system user account named netbox. We’ll configure the WSGI and HTTP services to run under this account. We’ll also assign this user ownership of the media directory. This ensures that NetBox will be able to save uploaded files.

sudo adduser --system --group netbox
sudo chown --recursive netbox /opt/netbox/netbox/media/

Move into the NetBox configuration directory and make a copy of named This file will hold all of your local configuration parameters.

cd /opt/netbox/netbox/netbox/
sudo cp
configure parameters of PostgreSQL, Redis , Secret key and allowed hosts in file
* in the allowed hosts means allow any host, if you want to allow specific hosts, configure accordingly
run the following command to setup the services
sudo apt install python3.8-venv 
sudo /opt/netbox/ 
sudo PYTHON=/usr/bin/python3.7 /opt/netbox/
Create a Super User

NetBox does not come with any predefined user accounts. You’ll need to create a superuser (administrative account) to be able to log into NetBox. First, enter the Python virtual environment created by the upgrade script:


source /opt/netbox/venv/bin/activate
cd /opt/netbox/netbox python3 createsuperuser

user: netbox

password: netbox@123 (user your password)

Schedule the Housekeeping Task

NetBox includes a housekeeping The management command handles recurring cleanup tasks, such as clearing out old sessions and expired change records. Although this command may be run manually, it is recommended to configure a scheduled job using the system’s cron daemon or a similar utility.

A shell script that invokes this command is included at contrib/ It can be copied to or linked from your system’s daily cron task directory or included within the crontab directly. (If installing NetBox into a nonstandard path, update the system paths within this script first.)

run the following command

sudo ln -s /opt/netbox/contrib/ /etc/cron.daily/netbox-housekeeping
Test the Application

Run the following command

python3 runserver --insecure
allow port in firewall

Run the following command

ufw allow 8000/tcp 
ufw reload 
Access the Dashboard
http://your server IP:8000
Setup Network

configure your sites and add your devices and other details according to your setup

Today you got the Setup Network, System, and Datacenter Documentation Server post.

Everything Linux, A.I, IT News, DataOps, Open Source and more delivered right to you.
"The best Linux newsletter on the web"
Solution Architect. passionate about exploring, deploying, and writing about new technologies related to systems, networks, cloud, and microservices.


Please enter your comment!
Please enter your name here

Latest articles

Join us on Facebook