Testing NetBox
We recommend the Getting Started Tutorial to get familiarised with NetBox in a Juju deployment.
This tutorial will allow you to test NetBox locally in the easiest possible way (not recommended for a production environment).
What you’ll do
Prerequisites
You need a machine where Multipass can be installed. You will need 4GB of RAM for the VM, so it is recommended that your computer has at least 8GB of RAM. Also 20GB of free disk space are needed.
Multipass can be easily installed in Linux, Windows and macOS. You will need a machine with amd64 architecture or an amd64 emulator, as the NetBox charm is only built for amd64.
Install Multipass
Follow the instruction in https://multipass.run/install.
Launch NetBox with a Multipass VM
You will launch a VM named netbox with Multipass, using the
cloud init configuration
that will install NetBox. This process will take about 20 minutes, depending on your computer and internet connection.
Run the next command to provision the VM with NetBox:
multipass launch -vvvv --cloud-init https://raw.githubusercontent.com/canonical/netbox/main/charm/cloudinit-juju-3.1.yaml --timeout 1800 --name netbox --memory 4G --cpus 3 --disk 20G 22.04
Congratulations, at this point your NetBox instance is installed and working. You can get the Netbox URL with the following command:
multipass exec netbox -- juju run traefik-k8s/0 show-proxied-endpoints --format=yaml
The previous command will output a URL similar to http://<your VM ip>/netbox-netbox. Open it with
with your favourite internet browser. However, you will not be able to do much without a user.
You can create an admin user with the next command:
multipass exec netbox -- juju run netbox/leader create-superuser username=admin email=netbox@example.com
The output of the previous command will output a password. You can now log in into the NetBox
webpage with the user admin and the previous password. You have now full access to NetBox!.
Once you are finished, you can delete the netbox VM with the next command:
multipass delete netbox --purge
Troubleshooting
You can see the output log in:
multipass exec netbox -- tail -f /var/log/cloud-init-output.log
And the commands executed with:
multipass exec netbox -- tail -f /var/log/cloud-init.log