Pulp uses dynaconf for its settings which allows you to configure Pulp settings using various ways:
Environment Variables - Enabled by default.
Configuration File - Disabled by default, but easy to enable. Enabled by
Configuration by specifying environment variables is enabled by default. Any
Setting can be configured using Dynaconf by prepending
PULP_ to the setting
name. For example SECRET_KEY can be specified as the
environment variable. For example, in a shell you can use
export to set this:
export PULP_SECRET_KEY="This should be a 50 chars or longer unique secret!"
By default, Pulp does not read settings from a configuration file. Enable this by specifying the
PULP_SETTINGS environment variable with the path to your configuration file. For example:
Then you can specify settings with Python variable assignment in the
example, you can specify SECRET_KEY with:
$ cat /etc/pulp/settings.py SECRET_KEY="This should be a 50 chars or longer unique secret!"
In this example the settings file ends in “.py” so it needs to be valid Python, but it could use any dynaconf supported format.
The configuration file and directories containing the configuration file must be readable by the
user Pulp runs as. If using SELinux, assign the
The pulp_installer enables configuration via a
settings file that lives at
/etc/pulp/settings.py. It does this by having each systemd file that
starts a Pulp service include:
A Pulp upgrade using
pulp_installer will override the original
To keep your settings through an upgrade, use the “local settings” file located at
/etc/pulp/settings.local.py which takes precedence over
/etc/pulp/settings.py on a