Configuring Dynaconf¶
Dynaconf can be configured through variables suffixed with those settings can be used to change various dynaconf defaults and behaviors.
Variable |
Type |
Usage |
default |
envvar example |
PROJECT_ROOT |
str |
Directory to look for settings |
“.” |
PROJECT_ROOT_FOR_DYNACONF=”/tmp” |
ENCODING |
str |
Encoding to read settings files |
utf-8 |
ENCODING_FOR_DYNACONF=”cp1252” |
SETTINGS_MODULE |
str |
List of comma separated files to load |
List of supportes files |
SETTINGS_MODULE_FOR_DYNACONF=”config.toml,settings.yaml” |
ENV |
str |
Working environment |
“development” |
ENV_FOR_DYNACONF=production |
GLOBAL_ENV |
str |
Prefix used for exporting parameters as env vars |
“DYNACONF” |
GLOBAL_ENV_FOR_DYNACONF=MYPROGRAM |
SILENT_ERRORS |
bool |
Loading errors should be silenced |
true |
SILENT_ERRORS_FOR_DYNACONF=false |
FRESH_VARS |
list |
A list of vars to be re-loaded on every access |
[] |
FRESH_VARS_FOR_DYNACONF=[“HOST”, “PORT”] |
DEBUG_LEVEL |
str |
Upper case logging level |
NOTSET |
DEBUG_LEVEL_FOR_DYNACONF=DEBUG |
DOTENV_PATH |
str |
defines where to look for .env file |
PROJECT_ROOT |
DOTENV_PATH_FOR_DYNACONF=”/tmp/.env”) |
DOTENV_OVERRIDE |
bool |
.env should override the exported envvars |
false` |
DOTENV_OVERRIDE_FOR_DYNACONF=true |
AUTO_CAST |
bool |
@casting like @int is parsed |
true |
DOTENV_OVERRIDE_FOR_DYNACONF=false |
MERGE_ENABLED |
bool |
Merge vars instead of overwriting them |
false |
MERGE_ENABLED_FOR_DYNACONF=true |
REDIS_ENABLED |
bool |
Redis loader is enabled |
false |
REDIS_ENABLED_FOR_DYNACONF=true |
VAULT_ENABLED |
bool |
Vault server is enabled |
false |
VAULT_ENABLED_FOR_DYNACONF=true |
REDIS_HOST |
str |
Redis server address |
localhost |
REDIS_HOST_FOR_DYNACONF=”localhost” |
REDIS_PORT |
int |
Redis port |
6379 |
REDIS_PORT_FOR_DYNACONF=8899 |
REDIS_DB |
int |
Redis DB |
0 |
REDIS_DB_FOR_DYNACONF=1 |
VAULT_URL |
str |
Vault URL |
http:// localhost :8200 |
VAULT_URL_FOR_DYNACONF=”http://server/8200” |
VAULT_TOKEN |
str |
vault token |
None |
VAULT_TOKEN_FOR_DYNACONF=myroot |
VAULT_CERT |
str |
vault cert/pem file path |
None |
VAULT_CERT_FOR_DYNACONF=”~/.ssh/key.pem” |
VAULT_VERIFY |
bool |
vault should verify |
None |
VAULT_VERIFY_FOR_DYNACONF=true |
INSTANCE |
str |
custom instance of LazySettings |
None |
INSTANCE_FOR_DYNACONF=myapp.settings |
-
dynaconf.
default_settings
¶ alias of
dynaconf.default_settings