Table of Contents

NetBox

NetBox functions as the source of truth for your network infrastructure. Its job is to define and validate the intended state of all network components and resources. NetBox does not interact with network nodes directly.

You can find our instance of NetBox here.

Do things in netbox

This is not a replace for the official manual, but for some common operations it could be helpful.

Add VM

You can add a VM inside NetBox in the Virtualization->Virtual Machines menu. As we use proxmox the name of the vm shoud be the same as the name inside proxmox, not the id.

The only options that we use are under the Site/Cluster and the Resources menus.

Add Interface

To bind an IP to a VM (or device) you should create an interface on the VM. After you’ve created the VM there is a blue button that let’s you add an interface. You can list the interfaces and their IPs with ip a in Linux.

Remember to add the MAC Address to the interface.

After the interface is created you can assign as many IPs you want.

Add IP address

All of our IPs are documented in NetBox and you can find them under the menu IPAM->IP Addresses. You can add an IP using the green button at the top right, but it’s probably best to add a device or a vm first.

If you’ve just created an interface you can add an IP to it by using the + button at the right of the interface. Make at least one IP primary.