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 (v2.5) , go to the latest version

Installing KrakenD API Gateway

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 license details to use the Enterprise content. Don’t have one? Ask for a trial version


If you are already familiar with Docker, the easiest way to get started is by pulling our KrakenD image

Pull KrakenD Enterprise 
$docker pull krakend/krakend-ee:2.5

After this command you will have in your local computer the krakend enterprise container.

Windows and Mac
Windows and Mac users have support through Docker containers.


Copy the license certificate to the server(s). Replace user@yourserver with your actual username and IP address:

ssh user@yourserver mkdir -p /etc/krakend/
scp LICENSE user@yourserver:/etc/krakend/LICENSE

CentOS/RockyLinux, Oracle Linux, and Redhat (yum)

The installation process requires following these steps:

  1. Install the repo package
  2. Install the KrakenD package
  3. Start the KrakenD service

Paste this in the terminal:

Yum based 
$rpm -Uvh
yum install -y krakend-ee
systemctl start krakend-ee


Paste this in the terminal:

DNF based 
$rpm -Uvh
dnf install -y krakend-ee
systemctl start krakend-ee

The current KrakenD version will run at least in Centos 7 and Fedora 24

Debian and Ubuntu

The installation process requires following these steps:

  1. Add the key
  2. Add the repo to the sources.list
  3. Update your package list
  4. Install the KrakenD service

Bottom line:

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

Minimum supported versions are Debian 8, and Ubuntu 16.x.

Generic Linux (tar.gz)

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

Download latest tar.gz (AMD64)

Download latest tar.gz (ARM64)

Once you have downloaded and uncompressed the binary, you should move the contents to each folder. You will need root permissions or add sudo to some of these commands:

mv usr/bin/krakend /usr/local/bin/krakend
mkdir -p /opt/krakend/
mv plugins /opt/krakend
chmod +x /usr/local/bin/krakend

Now you can type krakend.

To stop KrakenD graceful use any of these two commands:

killall -s SIGTERM krakend
killall -s SIGINT krakend

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.