Nuthshell: Quickest NetBox install for Demo or Production(recommended that you tweak slightly for production).
This repository houses the components needed to build NetBox using Vagrant and VirtualBox. It is a work in progress; please submit a bug report for any issues you encounter.
Vagrant Getting Started - Quick setup requires installing VirtualBox and Vagrant (selected your supported OS in the links below).
- VirtualBox - You can replace with other virtual platforms. See Vagrant Getting Started above.
- Vagrant
To get NetBox up and running:
- Install Virtual Platform & Vagrant (if not installed already)
- Clone netbox-vagrant git repo
# git clone https://github.com/ryanmerolle/netbox-vagrant/ .
or just download both Vagrantfile & bootstrap.sh and place in the directory you want to launch vagrant from. - Navigate to local repo directory & start vagrant
# vagrant up
- Log into VM (optional)
# vagrant ssh
- Play with Netbox demo in browser of choice http://netbox.localhost:8080 (Admin credentials use "admin" for userid and password - can be changed & credentials do not have quotes)
The normal NetBox upgrade process can be followed using the instructions to Clone the Git Repository (latest master release).
The NetBox installation process is followed leveraging:
- VM Memory: 4096 (edit Vagrantfile if you would like to change)
- VM CPUs: 2
- Ubuntu Xenial64 (updated)
- Python 2
- Cloning the Git Repository (as opposed to downloading a tar of a particular release)
- Apache (I'll convert this to ngnix soon)
- Netbox/Django superuser account is
admin
with a passwordadmin
and an email ofadmin@example.com
(can be changed after startup) - SECRET_KEY is randomly generated using generate_secret_key.py
- Postgres DB is setup using account is "nebox" with a password "J5brHrAXFLQSif0K" and the database "netbox" using the default port (all without quotes and can be changed after startup)
- Forwarded Ports - to add additional VM access / port forwarding (ssh, remote psql, etc)
- Vagrant Credentials - to understand credentials used for vagrant / Ubuntu VM
- bootstrap.sh can be used to bootstrap any Ubuntu Xenial setup & not just Vagrant
- netbox-vagrant setup files are deleted once VM is fully provisioned
- Additional Support Resources include:
- NetBox Github page
- NetBox Read the Docs
- NetBox-discuss mailing list
- Join the Network to Code community on Slack - Once setup join the #netbox room for help. I'm ryanmerolle & usually in this slack room.
- Join NetBox community on IRC in #netbox on irc.freenode.net! (@ryanmerolle does not join currently)