Skip to content

Getting Started with the App

This document provides a step-by-step tutorial on how to get the App going and how to use it.

Install the App

To install the App, please follow the instructions detailed in the Installation Guide.

First steps with the App

The easiest way to experience Design Builder is to either add the demo-designs as a git data source in an existing Nautobot environment, or in your local development environment.

The Design Builder demo designs ship with some sample designs to demonstrate capabilities. Once the application stack is ready, you should have several jobs listed under the "Jobs" -> "Jobs" menu item.

Jobs list Jobs list

Note that the jobs are disabled. Nautobot automatically marks jobs as disabled when they are first loaded. In order to run these jobs, click the edit button edit button edit button and check the "enabled" checkbox:

enabled checkbox enabled checkbox

Once you click save, the jobs should be runnable.

To implement any design, click the run button run buttonrun button. For example, run the "Initial Data" job, which will add a manufacturer, a device type, a device role, several regions and several sites. Additionally, each site will have two devices. If you run the job you should see output in the job result that shows the various objects being created:

design job result design job result

Once the initial data job has been run, try enabling and running the "Backbone Site Design" job to create a new site with racks and routers.