Document updated on Feb 16, 2022
KrakenD starts an HTTP server to offer the API Gateway server. You can personalize some of the settings used to start the service and also override the default settings of the underlying Go standard library.
If you want to customize any of the settings below, they must be written at the top level of the configuration.
|integer||The TCP port where KrakenD listens to. Recommended value is in the range 1024-65535 to run as an unpriviliged user. If you use ports under 1024 (e.g.: 80, 443) you’ll need to start the service as root. Defaults to |
|duration||Sets a default |
|duration||Is the maximum duration for reading the entire request, including the body. Because |
|duration||The amount of time allowed to read request headers. The connection’s read deadline is reset after reading the headers and the Handler can decide what is considered too slow for the body.|
|duration||The maximum duration before timing out writes of the response. It is reset whenever a new request’s header is read. Like |
|duration||The maximum amount of time to wait for the next request when keep-alives are enabled. If |
The duration is positive integer value with time units. Valid time units are:
h (hours - don’t!)
2s for 2 seconds or
1500ms for 1500 milliseconds.
When you declare in the configuration file any of the HTTP server settings declared above, you can override its value through environment variables when starting the server.
All the environment variables have the same name are the same settings above in uppercase and with the
KRAKEND_ preffix. For instance, looking at the list of settings above, you could override:
You can start KrakenD with the desired variables to override what you have in the configuration:
$KRAKEND_PORT=8000 KRAKEND_READ_TIMEOUT="1s" krakend run -c krakend.json
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.