NetBox Ansible Playbook

Playbook to setup NetBox on a host

Refer NetBox documentation here.

Installation

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.

Usage example

  • 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.

Built With

Authors

License

This project is licensed under GNU Affero General Public License v3.0 or later.