Skip to content

Configure Pulp

Pulp uses dynaconf for its settings which allows you to configure Pulp settings using various ways:

  • Environment Variables <env-var-settings> - Enabled by default.
  • Configuration File <config-file-settings> - Disabled by default, but easy to enable.

Through Environment Variables

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 <secret-key-setting> can be specified as the PULP_SECRET_KEY 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!"

Through Configuration File

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:

export PULP_SETTINGS=/etc/pulp/

Then you can specify settings with Python variable assignment in the /etc/pulp/ For example, you can specify SECRET_KEY <secret-key-setting> with:

$ cat /etc/pulp/
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 system_u:object_r:pulpcore_etc_t:s0 label.

View Settings

To list the effective settings on a Pulp installation, while on the system where Pulp is installed run the command dynaconf list. This will show the effective settings Pulp will use.


Settings can come from both settings file and environment variables. When running the dynaconf list command, be sure you have the same environment variables set as your Pulp installation.


For the dynaconf list command to succeed it needs to environment variable set identifying where the django settings file is. export