Logo NetBox

Networking & VPN

NetBox

NetBox on a VPS: document prefixes, IP addresses, VLANs, racks and cabling in one source of truth, driven by REST and GraphQL APIs.

In validation

About NetBox

NetBox is the leading open-source tool for documenting a network and its infrastructure, released under the Apache-2.0 license. It combines two disciplines: IPAM — prefixes, IP ranges and addresses, VLANs, VRFs — and DCIM — sites, racks, devices, interfaces and cables. Every object is linked to the others: an IP address belongs to an interface, which belongs to a device, mounted in a rack at a site.

For a team running servers, hosting or a company network, it ends the IP address spreadsheet nobody keeps up to date. Everything can also be read and written through the REST and GraphQL APIs: your Ansible inventories, Terraform or OpenTofu scripts and webhooks all start from the same source. The ServOrbit installation creates the administrator account and requires a login to view anything.

What gets installed

Ready when the VPS starts

Compatible OS
Choice of Linux distributions
Application
NetBox
Tech stack
DockerPythonPostgreSQLValkey
Minimum RAM
2 GB minimum
Minimum CPU
2 vCPU
Default port
8121
Access
root over SSH

Key features

  • Full IPAM — hierarchical prefixes, ranges, IP addresses, VLANs, VRFs and automatic free-space calculation.
  • DCIM — sites, racks with elevations, devices, modules, interfaces, cables and power.
  • A REST and GraphQL API for every object, with per-user API tokens and built-in OpenAPI documentation.
  • Automation — webhooks, custom scripts and a dynamic inventory for Ansible.
  • Change log — who changed what and when, object by object.
  • Closed by default — login required to view anything, administrator account created at install time.

When to use this solution?

Replace the IP address spreadsheet

Every prefix and IP address is assigned to a device or a customer: no more duplicate addresses, and the free space of a network is one click away.

Document a server room or a rack

Racks, devices, ports and cables are described once; the operations team knows what is plugged where before touching anything.

Feed Ansible and your scripts

The Ansible dynamic inventory and your scripts read the list of servers, their roles and their addresses from NetBox instead of a hand-maintained file.

Guide

Deploy NetBox on your VPS

  1. Create the VPS and choose the address

    Order an Ubuntu 24.04 VPS with at least 2 GB of RAM (4 GB recommended) and 2 vCPUs. NetBox requires a domain: it is served over HTTPS and only accepts forms from its declared address. It opens on a subdomain of one of your domains, or on the VPS's free subdomain (netbox.{dns_slug}.servorbit-dns.com), HTTPS included. No need to buy a domain name.

  2. Install NetBox from the Marketplace

    In your client area, select NetBox, choose the address and click Install. The script deploys the official netbox-docker image with PostgreSQL, Valkey and the background worker, generates the administrator password and the instance secrets, and configures the nginx reverse proxy with HTTPS. The first start applies the database migrations: allow five to ten minutes.

  3. Log in for the first time

    Open https://your-domain/login/ and sign in with the admin user and the password shown in your client area. This account is the instance superuser; you can change its password from your profile.

  4. Describe your first site

    Create a site, then your IP prefixes (IPAM, Prefixes) and your devices (Devices). NetBox calculates the free space of each prefix and suggests the next available address. CSV or YAML import lets you bring in an existing spreadsheet in one go.

  5. Create an API token

    From your profile, API Tokens menu, create a token for your scripts. It goes in the Authorization: Bearer <token> header; the interactive API documentation is served at https://your-domain/api/schema/swagger-ui/.

Frequently asked questions

Questions about NetBox

← Back to Networking & VPNAll applications
Yes, and it goes further: every IP address is tied to an interface, a device and a site, the free space of each prefix is calculated, and every change is logged. CSV import lets you bring in your existing spreadsheet.

Need help?

Browse our help center and FAQ, or reach our team — callback, WhatsApp or email.

Message us on WhatsAppopens in a new tab