Playbook to setup NetBox on a host
Refer NetBox documentation here.
You need to have Ansible installed on your local system (or whichever "admin" server you choose). Ansible is "agentless", using SSH to push changes to remote resources. The only requirements for the remote resource are that a Python interpreter be installed and SSHD be running.
Clone this repository onto your local system with the following command:
git clone --recurse-submodules https://github.com/npalladium/netbox-ansible-playbook.git
A normal git clone will not work as this repo uses submodules.
if you want to clone and update the submodules to their latest revision:
git clone --recurse-submodules --remote-submodules https://github.com/npalladium/netbox-ansible-playbook.git
Alternatively, the roles can be installed using ansible-galaxy.
- Change the
inventory
file to point towards your server. - Run
ansible-playbook netbox-setup-playbook.yml -i inventory
.
If you are not running as a root user on the remote server, you will have to use ansible-playbook site.yml -i inventory --extra-vars "ansible_sudo_pass=yourPassword"
or add a ansible_sudo_pass='yourPassword'
variable to the inventory file.
Your netbox username is admin
and password is netbox
.
- Nikhil P - Initial work - npalladium
This project is licensed under GNU Affero General Public License v3.0 or later.