{"id":13575518,"url":"https://github.com/netbox-community/netbox-docker","last_synced_at":"2026-05-06T12:02:05.910Z","repository":{"id":37759437,"uuid":"88978363","full_name":"netbox-community/netbox-docker","owner":"netbox-community","description":"🐳  Docker Image of NetBox","archived":false,"fork":false,"pushed_at":"2026-05-06T10:24:57.000Z","size":1531,"stargazers_count":2609,"open_issues_count":16,"forks_count":1146,"subscribers_count":40,"default_branch":"release","last_synced_at":"2026-05-06T11:38:42.243Z","etag":null,"topics":["docker","docker-compose","docker-image","hacktoberfest","netbox","python"],"latest_commit_sha":null,"homepage":"https://github.com/netbox-community/netbox-docker/wiki","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/netbox-community.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":".github/FUNDING.yml","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,"notice":null,"maintainers":"MAINTAINERS.md","copyright":null,"agents":null,"dco":null,"cla":null},"funding":{"github":["cimnine","tobiasge"],"patreon":null,"open_collective":null,"ko_fi":null,"tidelift":null,"community_bridge":null,"liberapay":null,"issuehunt":null,"otechie":null,"custom":null}},"created_at":"2017-04-21T11:46:28.000Z","updated_at":"2026-05-06T10:24:22.000Z","dependencies_parsed_at":"2023-12-02T10:29:50.627Z","dependency_job_id":"11e7c493-752d-40b4-95ca-9872f87a6c7e","html_url":"https://github.com/netbox-community/netbox-docker","commit_stats":{"total_commits":867,"total_committers":115,"mean_commits":7.539130434782609,"dds":0.7808535178777394,"last_synced_commit":"27bf52cf3ea882324273fbabbf23f0af6a194f12"},"previous_names":[],"tags_count":82,"template":false,"template_full_name":null,"purl":"pkg:github/netbox-community/netbox-docker","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/netbox-community%2Fnetbox-docker","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/netbox-community%2Fnetbox-docker/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/netbox-community%2Fnetbox-docker/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/netbox-community%2Fnetbox-docker/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/netbox-community","download_url":"https://codeload.github.com/netbox-community/netbox-docker/tar.gz/refs/heads/release","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/netbox-community%2Fnetbox-docker/sbom","scorecard":{"id":359600,"data":{"date":"2025-08-11","repo":{"name":"github.com/netbox-community/netbox-docker","commit":"477decd80af739e1eaa03c20a9ccd3ddd699818a"},"scorecard":{"version":"v5.2.1-40-gf6ed084d","commit":"f6ed084d17c9236477efd66e5b258b9d4cc7b389"},"score":4.9,"checks":[{"name":"Code-Review","score":10,"reason":"all changesets reviewed","details":null,"documentation":{"short":"Determines if the project requires human code review before pull requests (aka merge requests) are merged.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#code-review"}},{"name":"Packaging","score":-1,"reason":"packaging workflow not detected","details":["Warn: no GitHub/GitLab publishing workflow detected."],"documentation":{"short":"Determines if the project is published as a package that others can easily download, install, easily update, and uninstall.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#packaging"}},{"name":"Token-Permissions","score":0,"reason":"detected GitHub workflow tokens with excessive permissions","details":["Info: jobLevel 'packages' permission set to 'read': .github/workflows/push.yml:23","Warn: jobLevel 'statuses' permission set to 'write': .github/workflows/push.yml:24","Info: jobLevel 'contents' permission set to 'read': .github/workflows/push.yml:22","Warn: no topLevel permission defined: .github/workflows/push.yml:1","Warn: no topLevel permission defined: .github/workflows/release.yml:1"],"documentation":{"short":"Determines if the project's workflows follow the principle of least privilege.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#token-permissions"}},{"name":"Binary-Artifacts","score":10,"reason":"no binaries found in the repo","details":null,"documentation":{"short":"Determines if the project has generated executable (binary) artifacts in the source repository.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#binary-artifacts"}},{"name":"Maintained","score":1,"reason":"0 commit(s) and 2 issue activity found in the last 90 days -- score normalized to 1","details":null,"documentation":{"short":"Determines if the project is \"actively maintained\".","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#maintained"}},{"name":"Dangerous-Workflow","score":10,"reason":"no dangerous workflow patterns detected","details":null,"documentation":{"short":"Determines if the project's GitHub Action workflows avoid dangerous patterns.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#dangerous-workflow"}},{"name":"CII-Best-Practices","score":0,"reason":"no effort to earn an OpenSSF best practices badge detected","details":null,"documentation":{"short":"Determines if the project has an OpenSSF (formerly CII) Best Practices Badge.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#cii-best-practices"}},{"name":"Pinned-Dependencies","score":0,"reason":"dependency not pinned by hash detected -- score normalized to 0","details":["Warn: GitHub-owned GitHubAction not pinned by hash: .github/workflows/push.yml:26: update your workflow using https://app.stepsecurity.io/secureworkflow/netbox-community/netbox-docker/push.yml/release?enable=pin","Warn: third-party GitHubAction not pinned by hash: .github/workflows/push.yml:32: update your workflow using https://app.stepsecurity.io/secureworkflow/netbox-community/netbox-docker/push.yml/release?enable=pin","Warn: GitHub-owned GitHubAction not pinned by hash: .github/workflows/push.yml:73: update your workflow using https://app.stepsecurity.io/secureworkflow/netbox-community/netbox-docker/push.yml/release?enable=pin","Warn: third-party GitHubAction not pinned by hash: .github/workflows/push.yml:76: update your workflow using https://app.stepsecurity.io/secureworkflow/netbox-community/netbox-docker/push.yml/release?enable=pin","Warn: GitHub-owned GitHubAction not pinned by hash: .github/workflows/release.yml:35: update your workflow using https://app.stepsecurity.io/secureworkflow/netbox-community/netbox-docker/release.yml/release?enable=pin","Warn: third-party GitHubAction not pinned by hash: .github/workflows/release.yml:50: update your workflow using https://app.stepsecurity.io/secureworkflow/netbox-community/netbox-docker/release.yml/release?enable=pin","Warn: third-party GitHubAction not pinned by hash: .github/workflows/release.yml:58: update your workflow using https://app.stepsecurity.io/secureworkflow/netbox-community/netbox-docker/release.yml/release?enable=pin","Warn: third-party GitHubAction not pinned by hash: .github/workflows/release.yml:67: update your workflow using https://app.stepsecurity.io/secureworkflow/netbox-community/netbox-docker/release.yml/release?enable=pin","Warn: third-party GitHubAction not pinned by hash: .github/workflows/release.yml:76: update your workflow using https://app.stepsecurity.io/secureworkflow/netbox-community/netbox-docker/release.yml/release?enable=pin","Warn: containerImage not pinned by hash: Dockerfile:2","Warn: containerImage not pinned by hash: Dockerfile:47","Info:   0 out of   3 GitHub-owned GitHubAction dependencies pinned","Info:   0 out of   6 third-party GitHubAction dependencies pinned","Info:   0 out of   2 containerImage dependencies pinned"],"documentation":{"short":"Determines if the project has declared and pinned the dependencies of its build process.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#pinned-dependencies"}},{"name":"Security-Policy","score":0,"reason":"security policy file not detected","details":["Warn: no security policy file detected","Warn: no security file to analyze","Warn: no security file to analyze","Warn: no security file to analyze"],"documentation":{"short":"Determines if the project has published a security policy.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#security-policy"}},{"name":"Fuzzing","score":0,"reason":"project is not fuzzed","details":["Warn: no fuzzer integrations found"],"documentation":{"short":"Determines if the project uses fuzzing.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#fuzzing"}},{"name":"License","score":10,"reason":"license file detected","details":["Info: project has a license file: LICENSE:0","Info: FSF or OSI recognized license: Apache License 2.0: LICENSE:0"],"documentation":{"short":"Determines if the project has defined a license.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#license"}},{"name":"Signed-Releases","score":-1,"reason":"no releases found","details":null,"documentation":{"short":"Determines if the project cryptographically signs release artifacts.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#signed-releases"}},{"name":"Vulnerabilities","score":10,"reason":"0 existing vulnerabilities detected","details":null,"documentation":{"short":"Determines if the project has open, known unfixed vulnerabilities.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#vulnerabilities"}},{"name":"Branch-Protection","score":-1,"reason":"internal error: error during branchesHandler.setup: internal error: githubv4.Query: Resource not accessible by integration","details":null,"documentation":{"short":"Determines if the default and release branches are protected with GitHub's branch protection settings.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#branch-protection"}},{"name":"SAST","score":0,"reason":"SAST tool is not run on all commits -- score normalized to 0","details":["Warn: 0 commits out of 30 are checked with a SAST tool"],"documentation":{"short":"Determines if the project uses static code analysis.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#sast"}}]},"last_synced_at":"2025-08-18T10:28:12.949Z","repository_id":37759437,"created_at":"2025-08-18T10:28:12.949Z","updated_at":"2025-08-18T10:28:12.949Z"},"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":32692774,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-05-06T08:33:17.875Z","status":"ssl_error","status_checked_at":"2026-05-06T08:33:17.221Z","response_time":117,"last_error":"SSL_connect returned=1 errno=0 peeraddr=140.82.121.6:443 state=error: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"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","docker-compose","docker-image","hacktoberfest","netbox","python"],"created_at":"2024-08-01T15:01:01.752Z","updated_at":"2026-05-06T12:02:05.904Z","avatar_url":"https://github.com/netbox-community.png","language":"Python","funding_links":["https://github.com/sponsors/cimnine","https://github.com/sponsors/tobiasge"],"categories":["Python","Deployment","python"],"sub_categories":[],"readme":"# netbox-docker\n\n[![GitHub release (latest by date)](https://img.shields.io/github/v/release/netbox-community/netbox-docker)][github-release]\n[![GitHub stars](https://img.shields.io/github/stars/netbox-community/netbox-docker)][github-stargazers]\n![GitHub closed pull requests](https://img.shields.io/github/issues-pr-closed-raw/netbox-community/netbox-docker)\n![Github release workflow](https://img.shields.io/github/actions/workflow/status/netbox-community/netbox-docker/release.yml?branch=release)\n![Docker Pulls](https://img.shields.io/docker/pulls/netboxcommunity/netbox)\n[![GitHub license](https://img.shields.io/github/license/netbox-community/netbox-docker)][netbox-docker-license]\n\n[The GitHub repository][netbox-docker-github] houses the components needed to build NetBox as a container.\nImages are built regularly using the code in that repository\nand are pushed to [Docker Hub][netbox-dockerhub],\n[Quay.io][netbox-quayio] and [GitHub Container Registry][netbox-ghcr].\n_NetBox Docker_ is a project developed and maintained by the _NetBox_ community.\n\nDo you have any questions?\nBefore opening an issue on GitHub,\nplease join [our Slack][netbox-docker-slack]\nand ask for help in the [`#netbox-docker`][netbox-docker-slack-channel] channel,\nor start a new [GitHub Discussion][github-discussions].\n\n[github-stargazers]: https://github.com/netbox-community/netbox-docker/stargazers\n[github-release]: https://github.com/netbox-community/netbox-docker/releases\n[netbox-dockerhub]: https://hub.docker.com/r/netboxcommunity/netbox/\n[netbox-quayio]: https://quay.io/repository/netboxcommunity/netbox\n[netbox-ghcr]: https://github.com/netbox-community/netbox-docker/pkgs/container/netbox\n[netbox-docker-github]: https://github.com/netbox-community/netbox-docker/\n[netbox-docker-slack]: https://join.slack.com/t/netdev-community/shared_invite/zt-mtts8g0n-Sm6Wutn62q_M4OdsaIycrQ\n[netbox-docker-slack-channel]: https://netdev-community.slack.com/archives/C01P0GEVBU7\n[netbox-slack-channel]: https://netdev-community.slack.com/archives/C01P0FRSXRV\n[netbox-docker-license]: https://github.com/netbox-community/netbox-docker/blob/release/LICENSE\n[github-discussions]: https://github.com/netbox-community/netbox-docker/discussions\n\n## Quickstart\n\nTo get _NetBox Docker_ up and running run the following commands.\nThere is a more complete [_Getting Started_ guide on our wiki][wiki-getting-started] which explains every step.\n\n```bash\ngit clone -b release https://github.com/netbox-community/netbox-docker.git\ncd netbox-docker\n# Copy the example override file\ncp docker-compose.override.yml.example docker-compose.override.yml\n# Read and edit the file to your liking\ndocker compose pull\ndocker compose up\n```\n\nThe whole application will be available after a few minutes.\nOpen the URL `http://0.0.0.0:8000/` in a web-browser.\nYou should see the NetBox homepage.\n\nTo create the first admin user run this command:\n\n```bash\ndocker compose exec netbox /opt/netbox/netbox/manage.py createsuperuser\n```\n\nIf you need to restart Netbox from an empty database often,\nyou can also set the `SUPERUSER_*` variables in your `docker-compose.override.yml`.\n\n[wiki-getting-started]: https://github.com/netbox-community/netbox-docker/wiki/Getting-Started\n\n## Container Image Tags\n\nNew container images are built and published automatically every ~24h.\n\n\u003e We recommend to use either the `vX.Y.Z-a.b.c` tags or the `vX.Y-a.b.c` tags in production!\n\n- `vX.Y.Z-a.b.c`, `vX.Y-a.b.c`:\n  These are release builds containing _NetBox version_ `vX.Y.Z`.\n  They contain the support files of _NetBox Docker version_ `a.b.c`.\n  You must use _NetBox Docker version_ `a.b.c` to guarantee the compatibility.\n  These images are automatically built from [the corresponding releases of NetBox][netbox-releases].\n- `latest-a.b.c`:\n  These are release builds, containing the latest stable version of NetBox.\n  They contain the support files of _NetBox Docker version_ `a.b.c`.\n  You must use _NetBox Docker version_ `a.b.c` to guarantee the compatibility.\n- `snapshot-a.b.c`:\n  These are prerelease builds.\n  They contain the support files of _NetBox Docker version_ `a.b.c`.\n  You must use _NetBox Docker version_ `a.b.c` to guarantee the compatibility.\n  These images are automatically built from the [`main` branch of NetBox][netbox-main].\n\nFor each of the above tag, there is an extra tag:\n\n- `vX.Y.Z`, `vX.Y`:\n  This is the same version as `vX.Y.Z-a.b.c` (or `vX.Y-a.b.c`, respectively).\n- `latest`\n  This is the same version as `latest-a.b.c`.\n  It always points to the latest version of _NetBox Docker_.\n- `snapshot`\n  This is the same version as `snapshot-a.b.c`.\n  It always points to the latest version of _NetBox Docker_.\n\n[netbox-releases]: https://github.com/netbox-community/netbox/releases\n[netbox-main]: https://github.com/netbox-community/netbox/tree/main\n\n## Documentation\n\nPlease refer [to our wiki on GitHub][netbox-docker-wiki] for further information on how to use the NetBox Docker image properly.\nThe wiki covers advanced topics such as using files for secrets, configuring TLS, deployment to Kubernetes, monitoring and configuring LDAP.\n\nOur wiki is a community effort.\nFeel free to correct errors, update outdated information or provide additional guides and insights.\n\n[netbox-docker-wiki]: https://github.com/netbox-community/netbox-docker/wiki/\n\n## Getting Help\n\nFeel free to ask questions in our [GitHub Community][netbox-community]\nor [join our Slack][netbox-docker-slack] and ask [in our channel `#netbox-docker`][netbox-docker-slack-channel],\nwhich is free to use and where there are almost always people online that can help you.\n\nIf you need help with using NetBox or developing for it or against it's API\nyou may find [the `#netbox` channel][netbox-slack-channel] on the same Slack instance very helpful.\n\n[netbox-community]: https://github.com/netbox-community/netbox-docker/discussions\n\n## Dependencies\n\nThis project relies only on _Docker_ and _docker-compose_ meeting these requirements:\n\n- The _Docker version_ must be at least `20.10.10`.\n- The _containerd version_ must be at least `1.5.6`.\n- The _docker-compose version_ must be at least `1.28.0`.\n\nTo check the version installed on your system run `docker --version` and `docker compose version`.\n\n## Updating\n\nPlease read [the release notes][releases] carefully when updating to a new image version.\nNote that the version of the NetBox Docker container image must stay in sync with the version of the Git repository.\n\nIf you update for the first time, be sure [to follow our _How To Update NetBox Docker_ guide in the wiki][netbox-docker-wiki-updating].\n\n[releases]: https://github.com/netbox-community/netbox-docker/releases\n[netbox-docker-wiki-updating]: https://github.com/netbox-community/netbox-docker/wiki/Updating\n\n## Rebuilding the Image\n\n`./build.sh` can be used to rebuild the container image.\nSee `./build.sh --help` for more information or `./build-latest.sh` for an example.\n\nFor more details on custom builds [consult our wiki][netbox-docker-wiki-build].\n\n[netbox-docker-wiki-build]: https://github.com/netbox-community/netbox-docker/wiki/Build\n\n## Tests\n\nWe have a test script.\nIt runs NetBox's own unit tests and ensures that NetBox starts:\n\n```bash\nIMAGE=docker.io/netboxcommunity/netbox:latest ./test.sh\n```\n\n## Support\n\nThis repository is currently maintained by the community.\nThe community is expected to help each other.\n\nPlease consider sponsoring the maintainers of this project.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fnetbox-community%2Fnetbox-docker","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fnetbox-community%2Fnetbox-docker","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fnetbox-community%2Fnetbox-docker/lists"}