Nautobot Lab
This container is not for production use!
Nautobot Lab is an all-in-one Docker container that allows a user to quickly get an instance of Nautobot up and running with minimal effort.
This image is for the purposes of "kicking the tires" of Nautobot. Utilize nautobot-lab to quickly see if Nautobot is right for you and your organization.
It bears repeating, nautobot-lab is NOT a ready for production container. If you wish to use Nautobot in production, please refer to the Nautobot documentation.
Running from Docker Hub
Building the container yourself isn't needed to get up and running quickly. The image is hosted on Docker Hub for public consumption, and you can download and start it with a single command. You will still need to create a Super User as shown below.
docker run -itd --name nautobot -p 8000:8000 networktocode/nautobot-lab
Because this image is an all-in-one container (with Nautobot, PostgreSQL, and Redis), it will take a few seconds to download the container, and then about 30 seconds more for all of the services to start and stabilize. Once the container has started and all services have stabilized, the web interface can be accessed via http://localhost:8000.
If you wish, you can also check the health status of the container by running the following command:
docker ps | grep nautobot
You are waiting for the container to be in a healthy state as shown below.
99c9312e0409 networktocode/nautobot-lab "/usr/local/bin/supe…" 3 minutes ago Up 3 minutes (healthy) 0.0.0.0:8000->8000/tcp, :::8000->8000/tcp
Building the container
The container can be built locally, if preferred.
-
Clone the repository.
git clone https://github.com/nautobot/nautobot-lab.git
-
Enter the
nautobot-labdirectory. -
Build the image.
docker build -t nautobot-lab:latest .
Running the container from a local build
docker run -itd --name nautobot -p 8000:8000 nautobot-lab
Creating a Super User
Once the container has started and all the services have stabilized, you will need to create a superuser account to start exploring Nautobot. The nautobot-server createsuperuser command will prompt you for a username, email address, and password. The email address is unused in this particular workflow and can be left blank.
% docker exec -it nautobot nautobot-server createsuperuser
Username (leave blank to use 'root'): ntc
Email address: [email protected]
Password:
Password (again):
Superuser created successfully.
Kick the Tires
At this point, Nautobot can be accessed at http://localhost:8000 with the user credentials that were created.
Explore, test, create, destroy, do whatever you like in this lab instance of Nautobot.
If you have any questions, don't hesitate to reach out in the #Nautobot channel on the Network To Code Slack instance, we'll be happy to assist you!
If you're not a member, you can join the Slack instance here.
/
31 Oct 10, 2022
684 Nov 02, 2022
12 Apr 07, 2022
37 Sep 15, 2022
472 Dec 21, 2022
46 Dec 15, 2022
69 Dec 03, 2022
35 Dec 06, 2022
5 Jun 21, 2022
73 Dec 18, 2022
1 May 17, 2022
[email protected]">
188 Dec 12, 2022
136 Dec 23, 2022
17 Aug 08, 2022
19 Jan 25, 2022
626 Dec 31, 2022
18 Jul 19, 2022
294 Dec 30, 2022
5 Sep 07, 2022
182 Dec 20, 2022