{"id":18445479,"url":"https://github.com/nautobot/nautobot-lab","last_synced_at":"2025-08-16T05:37:13.983Z","repository":{"id":43330538,"uuid":"344931785","full_name":"nautobot/nautobot-lab","owner":"nautobot","description":"All-in-one Docker container that allows a user to explore Nautobot in a lab environment.","archived":false,"fork":false,"pushed_at":"2025-07-15T09:55:14.000Z","size":2535,"stargazers_count":42,"open_issues_count":7,"forks_count":12,"subscribers_count":13,"default_branch":"main","last_synced_at":"2025-07-15T21:56:47.258Z","etag":null,"topics":["docker","nautobot"],"latest_commit_sha":null,"homepage":"","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"apache-2.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/nautobot.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null}},"created_at":"2021-03-05T20:55:17.000Z","updated_at":"2025-01-06T12:31:13.000Z","dependencies_parsed_at":"2024-01-26T04:31:30.647Z","dependency_job_id":"4c8e2380-408e-42b4-8fcd-a12495a12540","html_url":"https://github.com/nautobot/nautobot-lab","commit_stats":{"total_commits":142,"total_committers":10,"mean_commits":14.2,"dds":"0.11267605633802813","last_synced_commit":"d8747cc3e5ddb7d4b8d3fb230bffe78e51273a3b"},"previous_names":[],"tags_count":29,"template":false,"template_full_name":null,"purl":"pkg:github/nautobot/nautobot-lab","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/nautobot%2Fnautobot-lab","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/nautobot%2Fnautobot-lab/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/nautobot%2Fnautobot-lab/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/nautobot%2Fnautobot-lab/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/nautobot","download_url":"https://codeload.github.com/nautobot/nautobot-lab/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/nautobot%2Fnautobot-lab/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":270672529,"owners_count":24625985,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","status":"online","status_checked_at":"2025-08-16T02:00:11.002Z","response_time":91,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["docker","nautobot"],"created_at":"2024-11-06T07:06:04.677Z","updated_at":"2025-08-16T05:37:13.957Z","avatar_url":"https://github.com/nautobot.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Nautobot Lab\n\n\u003e This container is **not** for production use!\n\n`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.\n\nThis 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.\n\nIt 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](https://nautobot.readthedocs.io/en/latest/installation/).\n\n## Running from Docker Hub\n\nBuilding 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.\n\n```shell\ndocker run -itd --name nautobot -p 8000:8000 networktocode/nautobot-lab\n```\n\n\u003e If you've previously run `nautobot-lab` in the past, you may wish to first invoke `docker pull networktocode/nautobot-lab` to ensure that you have the latest version of this image!\n\nBecause 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`.\n\nIf you wish, you can also check the health status of the container by running the following command:\n\n```shell\ndocker ps | grep nautobot\n```\n\nYou are waiting for the container to be in a `healthy` state as shown below.\n\n```text\n99c9312e0409   networktocode/nautobot-lab     \"/usr/local/bin/supe…\"   3 minutes ago   Up 3 minutes (healthy)   0.0.0.0:8000-\u003e8000/tcp, :::8000-\u003e8000/tcp\n```\n\nOnce Nautobot Lab is up and running, you will need to [create a Super User as shown in the section below](#Creating-a-Super-User).\n\n## Building the container\n\nThe container can be built locally, if preferred.\n\n1.  Clone the repository.\n\n    ```shell\n    git clone https://github.com/nautobot/nautobot-lab.git\n    ```\n\n2.  Enter the `nautobot-lab` directory.\n3.  Build the image.\n\n    ```shell\n    docker build -t nautobot-lab:latest .\n    ```\n\n### Running the container from a local build\n\n```shell\ndocker run -itd --name nautobot -p 8000:8000 nautobot-lab\n```\n\n### Importing the demo dataset\n\nThe nautobot-lab container provides demo dataset similar to the Nautobot public sandbox (http://demo.nautobot.com).\nThis dataset can be used to quickly populate your Nautobot instance with the real life data! You can use it to view data, experiment or perform experimental or development work.\n\nUse following command to import the data into your lab container:\n```shell\ndocker exec -itd nautobot load-mock-data\n```\n\n!!! warning\n    **Importing dataset will erase your existing data**. Issuing the `load-mock-data` will result in destroying your existing dataset and importing new one.\n    **Dataset contains default credentials**. If you decide to import provided dataset, the dataset credentials will be used: username: `admin`, password: `admin`.\n\n## The Default Account\n\nThe nautobot-lab container comes with a user pre-defined. The username is `demo` and its corresponding password is `nautobot`. If you choose to build your own container, you can define your own attributes for the default account by setting the following environment variables before executing the  `docker build` command.\n\n* NAUTOBOT_USERNAME\n* NAUTOBOT_EMAIL\n* NAUTOBOT_PASSWORD\n* NAUTOBOT_TOKEN\n\n## Creating a Super User\n\nOnce the container has started and all the services have stabilized, you can create a Super User 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.\n\n```shell\n% docker exec -it nautobot nautobot-server createsuperuser\nUsername (leave blank to use 'root'): ntc\nEmail address: info@networktocode.com\nPassword:\nPassword (again):\nSuperuser created successfully.\n```\n\n## Installed Applications\n\nThe Nautobot Lab container comes with the following applications pre-installed:\n* [Device Onboarding](https://docs.nautobot.com/projects/device-onboarding/en/latest/user/app_overview/)\n* [Circuit Maintenance](https://docs.nautobot.com/projects/circuit-maintenance/en/latest/user/app_overview/)\n* [Data Validation](https://docs.nautobot.com/projects/data-validation/en/latest/user/app_overview/)\n* [Capacity Metrics](https://github.com/nautobot/nautobot-plugin-capacity-metrics)\n* [Golden Config](https://docs.nautobot.com/projects/golden-config/en/latest/user/app_overview/)\n* [Nornir](https://docs.nautobot.com/projects/plugin-nornir/en/latest/user/app_overview/)\n* [Nautobot SSoT](https://docs.nautobot.com/projects/ssot/en/latest/user/app_overview/)\n* [Device Cycle Lifecycle Management](https://docs.nautobot.com/projects/device-lifecycle/en/latest/user/app_overview/)\n* [Firewall Models](https://docs.nautobot.com/projects/firewall-models/en/latest/user/app_overview/)\n* [BGP Models](https://docs.nautobot.com/projects/bgp-models/en/latest/user/app_overview/)\n* [Welcome Wizard](https://docs.nautobot.com/projects/welcome-wizard/en/latest/user/app_overview/)\n* [Floorplan](https://docs.nautobot.com/projects/floor-plan/en/latest/user/app_overview/)\n* [Design Builder](https://docs.nautobot.com/projects/design-builder/en/latest/user/app_overview/)\n\nThese applications can give you a sense of what is possible with Nautobot as a network automation platform and can assist you with populating the lab environment with data that is unique to you. For the applications that require access to network devices, you can set the `NAPALM_USERNAME` AND `NAPALM_PASSWORD` environment variables when starting the container.\n\n```shell\ndocker run -itd --name nautobot -p 8000:8000 --env NAPALM_USERNAME=\"demouser\" --env NAPALM_PASSWORD=\"demopass\" networktocode/nautobot-lab:latest\n```\n\n## Kick the Tires\n\nAt this point, Nautobot can be accessed at `http://localhost:8000` with the user credentials that were created.\n\nExplore, test, create, destroy, do whatever you like in this lab instance of Nautobot.\n\nIf you have any questions, don't hesitate to reach out in the #Nautobot channel on the [Network To Code Slack instance](https://networktocode.slack.com), we'll be happy to assist you!\n\nIf you're not a member, you can join the Slack instance [here](http://slack.networktocode.com/).\n\n![Nautobot](nautobot.png)\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fnautobot%2Fnautobot-lab","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fnautobot%2Fnautobot-lab","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fnautobot%2Fnautobot-lab/lists"}