KrakenD 1.0 is here!. Read our announcement.

Recent changes

Edit this page

KrakenD’s configuration file(s)

All the configuration that the KrakenD server needs to start and 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, 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.

Configuration using multiple files

If your configuration file is too large or repetitive, it can be split into several files using a templating system. See the flexible configuration documentation for more information on this feature.

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, and as it happens with all our software, is also open sourced and you can download it and run it in your own web server. See the Krakendesigner repository.

Generate configuration now

Supported file formats

The configuration file can be written as .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:

 
  • krakend check --config ./krakend.toml --debug 
  • Syntax OK! 

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.

Read more about krakend check

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.