ALERT!!! This is the outdated version of docs

Go to dynaconf.com for the new version docs.

dynaconf a layered configuration system for Python applications - with strong support for 12-factor applications and extensions for Flask and Django.

Release v2.2.3. (Installation)

https://img.shields.io/pypi/l/dynaconf.svg https://img.shields.io/pypi/pyversions/dynaconf.svg PyPI - Downloads https://img.shields.io/pypi/v/dynaconf.svg https://api.codacy.com/project/badge/Grade/5074f5d870a24ddea79def463453545b https://dev.azure.com/rochacbruno/dynaconf/_apis/build/status/rochacbruno.dynaconf?branchName=master Windows Build Linux Build https://codecov.io/gh/rochacbruno/dynaconf/branch/master/graph/badge.svg GitHub issues GitHub stars GitHub Release Date GitHub commits since latest release GitHub last commit Code Style Black Telegram

Dynaconf - Easy and Powerful Settings Configuration for Python

  • Strict separation of settings from code (following 12-factor applications Guide).
  • Define comprehensive default values.
  • Store parameters in multiple file formats (.toml, .json, .yaml, .ini and .py).
  • Sensitive secrets like tokens and passwords can be stored in safe places like .secrets file or vault server.
  • Parameters can optionally be stored in external services like Redis server.
  • Simple feature flag system.
  • Layered [environment] system.
  • Environment variables can be used to override parameters.
  • Support for .env files to automate the export of environment variables.
  • Correct data types (even for environment variables).
  • Have only one canonical settings module to rule all your instances.
  • Drop in extension for Flask app.config object.
  • Drop in extension for Django conf.settings object.
  • Powerful $ dynaconf CLI to help you manage your settings via console.
  • Customizable Validation System to ensure correct config parameters.
  • Allow the change of dynamic parameters on the fly without the need to redeploy your application.

Who is using Dynaconf?

  • Pulp Project - Django - (RedHat)
  • Ansible Galaxy - Django - (RedHat)
  • Insights QE (RedHat)
  • CloudForms QE (RedHat)
  • Seek AI & Catho Job boards - Flask - (on AI APIs)
  • Quokka CMS - Flask
  • iNNOVO Cloud GmbH
  • Teraki
  • ARA Records Ansible - Django

Are you using Dynaconf? Please give feedback

_images/aafig-2493a133423df86b1c4c65b80ec08ba20c8233c6.svg

Contents:

Indices and tables