Bot releases are visible (Hide)
To fix a problem with our QEMU based multi-arch we are now using the Docker buid cloud. This should improved the build time a bit and make the build more stable.
This version of NetBox Docker is only compatible with NetBox v4.1.x and above.
For older versions, use a previous release of NetBox Docker.
Published by tobiasge about 2 months ago
Image is now based on Ubuntu 24.04 and uses Python 3.12
Use Valkey because of the licence changes from Redis
Default was changed in NetBox (https://github.com/netbox-community/netbox/issues/16107 and https://github.com/netbox-community/netbox/pull/16122)
Default value is now 30s higher to give the migrations more time
This version of NetBox Docker is only compatible with NetBox v4.1.x and above.
For older versions, use a previous release of NetBox Docker.
Published by tobiasge 5 months ago
Because /api/ now requires a login when LOGIN_REQUIRED is true, we now use /login/ to check the container
Ensures that the Django integration for sentry-sdk
is installed
This version of NetBox Docker is only compatible with NetBox v4.0.x and above.
For older versions, use a previous release of NetBox Docker.
Published by tobiasge 6 months ago
See https://github.com/SAML-Toolkits/python3-saml/issues/389
We are now using Ubuntu 23.10 and Nginx Unit 1.32
The sentry-sdk is included in the image once again.
This version of NetBox Docker is only compatible with NetBox v4.0.x and above.
For older versions, use a previous release of NetBox Docker.
Published by tobiasge 10 months ago
Our docker-compose file was updated to use PostgreSQL 16.
Note that you will need to take manual action after you upgrade a live PostgreSQL database.
If your database is not too big, a full backup (with PostgreSQL 15, i.e. before the upgrade) and restore (with a clean PostgreSQL 15, i.e. after the upgrade) is probably the easiest to achieve. Our troubleshooting wiki page has instructions on how to backup and restore a Netbox database. Please test the procedure on a test system first!
Note that there is no requirement to update to PostgreSQL 16, you can stick to version 15 just fine. You could do this with a docker-compose.override.yml
like so:
version: '3.4'
services:
postgres:
image: postgres:15-alpine
This version of NetBox Docker is only compatible with NetBox v3.7.x and above.
For older versions, use a previous release of NetBox Docker.
Published by tobiasge about 1 year ago
Updated for new variable names in Netbox
Image is now based in Ubuntu 23.04 and Nginx Unit 1.30
Removed the z
option from bind mounts
Fixed for secret keys with $
Changed the default to match the value from Netbox
This can now be a list in Netbox
This version of NetBox Docker is only compatible with NetBox v3.6.x and above.
For older versions, use a previous release of NetBox Docker.
Published by tobiasge over 1 year ago
BASE_PATH
environment variabledocker-compose.yml
. If you currently have custom files in one of those directories, you will have to upload them into Netbox. This can be done in the UI.Using a current version
Version 2.6.0 had a typo in the version, which is fixed with this hot fix release
This version of NetBox Docker is only compatible with NetBox v3.5.x and above.
For older versions, use a previous release of NetBox Docker.
Published by tobiasge over 1 year ago
BASE_PATH
environment variabledocker-compose.yml
. If you currently have custom files in one of those directories, you will have to upload them into Netbox. This can be done in the UI.Using a current version
This version of NetBox Docker is only compatible with NetBox v3.5.x and above.
For older versions, use a previous release of NetBox Docker.
Published by tobiasge over 1 year ago
Updated to current version
Always use the version from Netbox
Improved tests on ARM64
Updated to current version
This version of NetBox Docker is only compatible with NetBox v3.4.x and above.
For older versions, use a previous release of NetBox Docker.
Published by tobiasge over 1 year ago
Fixes build for Netbox 3.4.7 and up
Updates to current version for django-auth-ldap
Use the full image name in docker-compose.yml
Improved the testing in Github Actions
This version of NetBox Docker is only compatible with NetBox v3.4.x and above.
For older versions, use a previous release of NetBox Docker.
Published by tobiasge over 1 year ago
Fixed startup problem
This version of NetBox Docker is only compatible with NetBox v3.4.x and above.
For older versions, use a previous release of NetBox Docker.
Published by tobiasge over 1 year ago
To improve security in production environment we don't create a default admin anymore
Improved stability for our build process
We are now using Nginx Unit 1.29.1
Update indexes on start when needed
Improved the filter settings for LDAP
Using the full image name to fixed errors with podman
Using the modern syntax for Github Actions ENV variables and output
Updated the build process to use the GITHUB_TOKEN
Redis username can now be set from ENV variables
Using modern syntax for docker compose
Added example for the health checks
Ensures that ALLOWED_HOSTS
is always set correctly
This version of NetBox Docker is only compatible with NetBox v3.4.x and above.
For older versions, use a previous release of NetBox Docker.
Published by tobiasge almost 2 years ago
Our docker-compose file was updated to use PostgreSQL 15.
Note that you will need to take manual action after you upgrade a live PostgreSQL database.
If your database is not too big, a full backup (with PostgreSQL 14, i.e. before the upgrade) and restore (with a clean PostgreSQL 15, i.e. after the upgrade) is probably the easiest to achieve. Our troubleshooting wiki page has instructions on how to backup and restore a Netbox database. Please test the procedure on a test system first!
Note that there is no requirement to update to PostgreSQL 15, you can stick to version 14 just fine. You could do this with a docker-compose.override.yml
like so:
version: '3.4'
services:
postgres:
image: postgres:14-alpine
The new settings LDAP_CA_CERT_* can now be configured in environment variables
We install only one version of psycopg2
All warnings regarding the old startup scripts were removed
The container can now be used with IPv6.
This fixed a bug were the housekeeping job was not run in the correct interval
All Python requirements for SAML authentication are now installed per default
This changes the startup order of the containers in the example compose file, which prevents a crash in the housekeeping job when the database was not yet initialised
All dynamic parameters can now be set correctly in the Netbox GUI when they aren't defined in environment variables.
To prevent docker from creating new random volumes every time the containers are started, we now define a fixed volume for both Redis containers.
JOBRESULT_RETENTION
can now be set from an environment variable
This version of NetBox Docker is only compatible with NetBox v3.4.x and above.
For older versions, use a previous release of NetBox Docker.
Published by cimnine almost 2 years ago
In the previous version, we began to clean up NetBox Docker to make it easier to maintain and so that it breaks less often, when the upstream NetBox team releases a new version.
This version continues with more maintenance related work. It also exposes two new variables as environment variables (one general, one ldap-specific) and allows the dynamic configuration parameters to be used, while still allowing them to be set via the environment for backwards compatibility.
In the next version we will probably update the PostgreSQL version from 14 to 15.
JOBRESULT_RETENTION
variable #840The PR #840 exposes a new variable JOBRESULT_RETENTION
as an environment variable.
Thanks @tymekxxl for the PR.
AUTH_LDAP_BIND_AS_AUTHENTICATING_USER
variable #779The PR #779 adds the new environment variable AUTH_LDAP_BIND_AS_AUTHENTICATING_USER
to the ldap configuration file. This allows NetBox Docker to bind to an LDAP server using username and password provided by the user being authenticated.
Thanks @BegBlev for the PR.
Fixes the behavior that the caching Redis, which is actually ephemeral, creates a lot of unmanaged volumes. That is, because that's what the Redis container declares in its manifest. #852 fixes this by defining a managed volume for the caching Redis, even though it's not required otherwise.
Thanks to @Delta1977 for the PR.
All the dynamic configuration parameters can now be configured via the web administration of NetBox. (You can still configure them via environment variables).
The following additional configuration parameters are now available to be configured via environment variables:
ALLOWED_URL_SCHEMES
DEVELOPER
INTERNAL_IPS
LOGIN_PERSISTENCE
CSRF_COOKIE_NAME
SESSION_COOKIE_NAME
POWERFEED_DEFAULT_AMPERAGE
POWERFEED_DEFAULT_MAX_UTILIZATION
POWERFEED_DEFAULT_VOLTAGE
Please refer to the NetBox documentation for their allowed values and proper use.
Thanks go out to @benwa for the submitting an earlier draft and bringing the topic onto our plate.
This version of NetBox Docker is only compatible with NetBox v3.3.x and above.
For older versions, use a previous release of NetBox Docker.
Published by tobiasge about 2 years ago
All startup scripts, initializers and ruamel.yaml
have been removed from the image. With this change we are now able to publish images faster after a release of a major NetBox version. The initializer functionality has been moved to a plugin. You can find this plugin here: https://github.com/tobiasge/netbox-initializers
Some examples in our Wiki use bzip2
to compress backup data. Now we have bzip2
actually in the image.
To make the test logs clearer we removed some logging output
Changelog for django-storages
This version of NetBox Docker is only compatible with NetBox v3.3.x and above.
For older versions, use a previous release of NetBox Docker.
Published by tobiasge about 2 years ago
With our venv in the path manage.py
commands can be started without absolute paths
Images for ARM64 are build and pushed to the registries
Because of some security concerns (#800) we use Ubuntu and its newer packages
OIDC SSO was missing some Python packages to work correctly
Restores the same behaviour that we had in the old Alpine images: LDAP connections use the certificates from the system store (#799).
This version of Netbox Docker is only compatible with Netbox v3.2.x and above.
For older versions, use a previous release of Netbox Docker.
Published by tobiasge over 2 years ago
This is a major release because the base image is now Debian 11. All users building their own images based on this one must check if they're using Alpine specific commands (like apk
). These have to be changed to the Debian version (apt
as example).
We are also not building images with the -ldap
tag anymore because that is now integrated into the main image.
Fixed custom fields problem in initalizers.
Running the startup scripts multiple times after changing values won't crash anymore
CSRF_TRUSTED_ORIGINS can now be set from ENV.
Added initializers for DeviceType components
Added initializers for Contacs and related objects.
MAPS_URL can now be set from ENV.
Added initializers for cables.
SKIP_GIT now skips all git calls
New major release of Napalm containing a fix that prevented our image from being build.
This version of Netbox Docker is only compatible with Netbox v3.2.x and above.
For older versions, use a previous release of Netbox Docker.
Published by tobiasge over 2 years ago
WARNING: This release includes a database migration that will remove the asn
, contact_name
, contact_phone
, and contact_email
fields from the site model. (These fields have been superseded by the ASN and contact models introduced in NetBox v3.1.) To protect against the accidental destruction of data, the upgrade process will fail if any sites still have data in any of these fields. To bypass this safeguard, set the NETBOX_DELETE_LEGACY_DATA
environment variable when running the upgrade script, which will permit the destruction of legacy data.
NOTE: A set of migration scripts is available to assist with the migration of legacy site data.
Use current versions for our workflow
Some minor changes to add compatibility with Netbox 3.2 were needed.
Version 3.4.0 of Napalm is used
This version of Netbox Docker is only compatible with Netbox v3.2.x and above.
For older versions, use a previous release of Netbox Docker.
Published by tobiasge over 2 years ago
ASN instances can be created from initializers
GraphQL can now be configured from ENV variables
The initializer scripts have been re-sorted to make the ordering more logical. Duplicates were removed. Thanks to @ryanmerolle
Some minor changes to add compatibility with Netbox 3.2 were needed (tzdata is installed, mkdocs fixed).
This version of Netbox Docker is only compatible with Netbox v3.1.x and above.
For older versions, use a previous release of Netbox Docker.
Published by tobiasge almost 3 years ago
Release build fixed
This version of Netbox Docker is only compatible with Netbox v3.1.x.
For older versions, use a previous release of Netbox Docker.