News KrakenD CE v2.7 released with better rate-limiting and security options

Enterprise Documentation

Recent changes

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

KrakenD Enterprise Installation Guide

Document updated on Feb 2, 2020

KrakenD Enterprise is delivered in several formats, including Docker, Linux packages (deb, rpm) and generic installation options.

Find your KrakenD License email
To download any Enterprise binaries, check your inbox and find our license activation email with the certificates to access the Enterprise content.


If you are already familiar with Docker, the easiest way to get started is by pulling our KrakenD image from Azure or AWS. As the repositories are private, you need to provide the credentials we sent.

From Amazon ECR

To pull our Docker image from AWS, you need to:

  1. Install the AWS CLI if you don’t have it yet.
  2. Add the credentials we provided
  3. Login to ECR
  4. Pull the container
  5. Push it to your registry

Save the credentials

The AWS credentials that you received need to be stored under ~/.aws/credentials. The file might looks like this (fake credentials below):

aws_access_key_id = AKIAQYWA47SCCDSQLWAN
aws_secret_access_key = xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx

If you already have credentials, add another named profile.

Login to ECR

Now you are ready to login into ECR and download the content. Depending on which version of the AWS CLI you have installed you might need one of these two commands:


Login to ECR with AWS CLI v2 
$aws ecr get-login-password --region us-east-1 | \
    	docker login --username AWS --password-stdin \


Login to ECR with AWS CLI v1 
$$(aws ecr get-login --region us-east-1 --no-include-email)

Pull the image and push to your registry

Running KrakenD using the Docker container 
$docker pull krakend/krakend-ee:1.3.0

If you have a corporate Docker registry you might want to push the image locally:

Running KrakenD using the Docker container 
$docker tag krakend/krakend-ee:1.3.0
docker push

From Azure Container Registry

To pull pur Docker image from Azure, you need to:

  1. Install Azure CLI
  2. Login to Azure with az login
  3. When the browser opens, use the credentials you have received from KrakenD
  4. az acr login --name krakend
  5. docker pull

After these commands you will have in your local computer the krakend enterprise container. You can push it to your own ACR or use it locally.

Linux installation (non-Docker)

The installation process requires going through these steps:

  1. Download de certificate chain
  2. Setup the KrakenD repository
  3. Install KrakenD
  4. Start the KrakenD service

Download the certificate

The first step to all Linux flavours is to download the certicate chain from our repository:

Downloading the CA chain 
$aws s3 cp s3:// /etc/krakend/krakend-ca-chain.pem

AWS-CLI needed. The credentials to access this bucket are provided in the welcoming email.

Debian and Ubuntu (apt)

Create a config file in /etc/apt/apt.conf.d/99krakend with this content: {
    CaInfo "/etc/krakend/krakend-ca-chain.pem";
    SslCert "/etc/krakend/LICENSE";
    SslKey  "/etc/krakend/LICENSE.key";

Make sure the three files referenced above are placed in /etc/krakend.

Run the following commands:

Install from deb 
$apt-key adv --keyserver --recv 5DE6FD698AD6FDD2
echo "deb stable main" | tee /etc/apt/sources.list.d/krakend-ee.list
apt-get update
apt-get install -y krakend-ee

Now the krakend command is available in the system.

KrakenD should run on old systems too, at least from Debian 8 and Ubuntu 16.x

CentOS and Redhat (yum)

The RPM file can be downloaded from here:

aws s3 cp s3:// .

Make sure the LICENSE files LICENSE, and LICENSE.key are placed in /etc/krakend.

Then install and start the latest version of KrakenD with:

Install with yum 
$rpm -Uvh krakend-ee-repo-1.0-2.x86_64.rpm
yum install krakend-ee
systemctl start krakend-ee

Generic linux install (via tar.gz)

You can also download a tar.gz and decompress it anywhere. Instructions to check the SHA and PGP signature here

Download tar gz 
$aws s3 cp s3:// .

aws s3 cp s3:// .
aws s3 cp s3:// .

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.