netbox-docker

The quokka netbox with plugins.

The newest netboxcommunity/netbox:vX.Y.Z image plus the plugins in plugin_requirements.txt and our config.

Images

docker.ethquokkaops.io/ethquokkaops/ethdevops/netbox-docker:<version>

Versions are <netbox major>.<netbox minor>.<netbox patch * 100 + build>: 4.7.200 is the first build on NetBox 4.7.2, 4.7.201 the next one (e.g. a plugin update), 4.7.300 the first on NetBox 4.7.3. Each GitHub release lists the exact NetBox and plugin versions inside.

Tag	Points to
4.7.201	exactly that build
4.7	latest build on NetBox 4.7
4	latest build on NetBox 4
latest	newest build

How it works

.github/workflows/docker.yaml runs every 6 hours, on push to main, and manually. It:

1. Looks up the newest vX.Y.Z tag of netboxcommunity/netbox on Docker Hub and builds on it without cache, so it also gets the latest plugin releases.
2. Writes a manifest.txt: NetBox version, every package the plugins added, and hashes of the build files.
3. Stops if that matches the manifest.txt of the latest GitHub release.
4. Otherwise pushes the image under the next version and creates a GitHub release with the manifest attached.

To force a rebuild, delete the latest release and run the workflow.

Caveats

• If a new NetBox release isn't supported by a plugin yet, the build fails at collectstatic and nothing is released until the plugin catches up.
• Base image rebuilds that keep the same NetBox version (e.g. OS security fixes) don't trigger a release on their own.
• GitHub disables scheduled workflows after 60 days without commits. Re-enable it in the Actions tab.