News KrakenD 2.1 released!

Documentation

Recent changes

You are viewing a previous version of KrakenD Enterprise Edition (v1.3) , go to the latest version

Overriding the configuration with environment vars

When KrakenD runs, all the behavior is loaded from the configuration file. For each configuration value that isn’t nested (meaning first-level properties of the configuration), you can override its value with an environment variable.

All configuration environment variables must have the prefix KRAKEND_ and declared in uppercase. The variable name after the prefix must match the property in the configuration value.

For instance, take the following krakend.json configuration as an example:

{
    "version": 2,
    "timeout": "3s",
    "name": "Example gateway."
}

Now run krakend with the following command:

Example: Override configuration with env vars 
$KRAKEND_NAME="Build ABC0123" KRAKEND_TIMEOUT="500ms" krakend run -c krakend.json 

The resulting configuration will be:

{
    "version": 2,
    "timeout": "500ms",
    "name": "Build ABC0123"
}

NOTE: The configuration file is not changed. The values above are a representation of the final mapped values.

Unresolved issues?

The documentation is only a piece of the help you can get! Whether you are looking for Open Source or Enterprise support, see more support channels that can help you.

We use cookies to understand how you use our site and to improve your overall experience. By continuing to use our site, you accept our Privacy Policy. More information