netbox/docs/configuration/index.html

# NetBox Configuration

NetBox's local configuration is stored in `netbox/netbox/configuration.py`. An example configuration is provided at `netbox/netbox/configuration.example.py`. 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.

* [Required settings](configuration/required-settings.md)
* [Optional settings](configuration/optional-settings.md)

## Changing the Configuration

Configuration settings may be changed at any time. However, the NetBox service must be restarted before the changes will take effect:

```no-highlight
# sudo supervsiorctl restart netbox
```