Customized NetBox Docker image based on NetBox v4.6.8. CI publishes kristianfoss/netbox:core for linux/amd64 and linux/arm64.
Dependencies from plugin_requirements.txt are installed during the build. configuration/load_plugin.py enables netbox_ipcalculator, netbox_topology_views, and netbox_lists while static assets are collected. The other packages are installed but are not enabled by this build-time configuration; enable and configure the plugins required by a deployment through the upstream NetBox Docker configuration mechanism.
| Package or source | Enabled while collecting static assets |
|---|---|
netbox-lists |
Yes (netbox_lists) |
netbox-ddns |
No |
netbox-ipcalculator |
Yes (netbox_ipcalculator) |
netbox-topology-views |
Yes (netbox_topology_views) |
netbox-plugin-device-map |
Yes (netbox_device_map) |
phonebox_plugin |
Yes (phonebox_plugin) |
netbox-opennms-plugin |
Yes (netbox_opennms) |
netbox-gateways |
No |
nb-service |
No |
netbox-plugin-dns |
No |
netbox-bgp |
No |
netbox_kea |
No |
netbox-data-flows |
No |
netbox-tunnels2 |
No |
netbox-inventory |
No |
netbox-contract |
No |
netbox-slm |
No |
netbox-routing |
No |
netbox-acls |
No |
The PyPI dependencies are unpinned, and netbox-ddns is installed from its mutable main branch, so plugin versions can change when the image is rebuilt.
The plugins enabled while collecting static assets are netbox_ipcalculator, netbox_topology_views, netbox_lists, netbox_device_map, and phonebox_plugin. The image copies only the static output and does not leave the temporary build-time configuration in the final layer.
Compatibility status at the NetBox 4.6.1 bump:
- Explicitly documented as 4.6-compatible upstream:
netbox-lists,netbox-acls,netbox-inventory. - Documented as compatible with the 4.6 line or with a broad enough lower bound that they are expected to work on 4.6, but not yet backed here by a repo-level compatibility check:
netbox-ipcalculator,netbox-data-flows. - Still requiring follow-up before this image can be called fully 4.6-ready:
netbox-topology-views,netbox-plugin-dns,netbox-gateways,netbox-contract,netbox-routing,nb-service,netbox-tunnels2,netbox_kea,netbox-plugin-device-map, andnetbox-ddnsfrommain.
The next maintenance step is to replace or pin the remaining lagging plugins to versions that explicitly declare NetBox 4.6 support, then re-test the build and collectstatic path before taking another NetBox minor update.
Runtime configuration, secrets, database, Redis, migrations, and startup behavior are inherited from the upstream image; follow the NetBox Docker plugin configuration and quickstart.
Build locally with docker build -t core-docker/netbox:local Images/NetBox.