Skip to content

NetBox Configuration

NetBox's local configuration is stored in $INSTALL_ROOT/netbox/netbox/ by default. An example configuration is provided as You may copy or rename the example configuration and make changes as appropriate. NetBox will not run without a configuration file. While NetBox has many configuration settings, only a few of them must be defined at the time of installation: these are defined under "required settings" below.

Customizing the Configuration Module

A custom configuration module may be specified by setting the NETBOX_CONFIGURATION environment variable. This must be a dotted path to the desired Python module. For example, a file named in the same directory as would be referenced as netbox.my_config.

For the sake of brevity, the NetBox documentation refers to the configuration file simply as

Some configuration parameters may alternatively be defined either in or within the administrative section of the user interface. Settings which are "hard-coded" in the configuration file take precedence over those defined via the UI.

Configuration Parameters

Changing the Configuration

The configuration file may be modified at any time. However, the WSGI service (e.g. Gunicorn) must be restarted before the changes will take effect:

$ sudo systemctl restart netbox

Configuration parameters which are set via the admin UI (those listed under "dynamic settings") take effect immediately.