Document updated on Oct 20, 2018
Configuration Guide for KrakenD API Gateway
All the setup a KrakenD server needs to operate is a single configuration file. This file is referred to as krakend.json
through all the documentation.
The name krakend.json
is just an alias, a convention, that we use everywhere. Your real configuration file can have any name, multiple formats (like YAML or TOML), be stored anywhere, or split in many pieces.
Provided this simple configuration mechanism, the versioning and automation are very convenient. Any change in the API Gateway is always under the version control system, and the code controls the state of the gateway.
Generating the configuration file(s)
The configuration file can be written from scratch or reuse another existing file as a base, but the easiest way to write your first configuration file is by simply using the online configuration editor KrakenDesigner.
The KrakenDesigner is a simple javascript application that helps you understand the capabilities of the API Gateway and helps you set the different values for all the different options. Using this option you don’t need to learn and write from scratch all the attribute names. The configuration file can be downloaded at any time and loaded again to resume the edition.
The Kraken Designer is a pure static page that does not send any of your configuration elsewhere.
Supported file formats
Through all the documentation we refer to the configuration file as the krakend.json
file, but the configuration file can be written using .json
, .toml
, .yaml
, .yml
, .properties
, .props
, .prop
or .hcl
. For more information and recommendations see supported file formats.
Validating the syntax of the configuration file
Validate the syntax (not the logic) of your configuration file using the krakend check
command:
Check the configuration
$krakend check --config ./krakend.toml --debug --lint
When the syntax is correct, you’ll see the message Syntax OK!
, otherwise the error is shown.
You can also start the service directly as this is done right before the server starts (except the linting).
Read more about krakend check
Contribute to KrakenD Documentation. Improve this page »