KrakenD Enterprise 2.0 released! Read the Release notes »

Community version (v2.0.4)

Recent changes

Installing KrakenD

KrakenD is a single binary file that does not require any external libraries to work. To install KrakenD choose your operative system in the downloads section or use the Docker image.

Installation

You can install (or just run) KrakenD using different options.

Just exploring?
Use the KrakenD Playground if you want to play with KrakenD without configuring it. The Playground comes with several flavors of KrakenD and a mock API. Everything is ready to start playing, just do a docker-compose up!

Docker

The easiest way to get started is by pulling and running the KrakenD image from the Docker Hub.

Running KrakenD using the Docker container 
$docker run -p 8080:8080 -v $PWD:/etc/krakend/ devopsfaith/krakend run --config /etc/krakend/krakend.json 

If you choose not to mount the volume (the -v), a default krakend.json serving a /__health endpoint will be used. The volume expects to find a krakend.json in the current directory (generate your first here).

AWS and Azure VM

See the downloads page for pre-built virtual machines in Azure and AWS.

Mac OS X

The Homebrew formula will download the source code, build the binary, and link the binary for you. The installation might take a while.

Install on Mac via Brew 
$brew install krakend 

After the installation completes go to Using KrakenD

Linux

CentOS and Redhat

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 https://repo.krakend.io/rpm/krakend-repo-0.2-0.x86_64.rpm 
yum install -y krakend 
systemctl start krakend 

Fedora

Paste this in the terminal:

DNF based 
$rpm -Uvh https://repo.krakend.io/rpm/krakend-repo-0.2-0.x86_64.rpm 
dnf install -y krakend 
systemctl start krakend 

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-key adv --keyserver keyserver.ubuntu.com --recv 5DE6FD698AD6FDD2 
echo "deb https://repo.krakend.io/apt stable main" | tee /etc/apt/sources.list.d/krakend.list 
apt-get update 
apt-get install -y krakend 

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.

Compile from source

As KrakenD is open source you can opt for building the binary. The binary you will produce is the same you can get in our download page, only that compiling it yourself always feels good!

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.

We use cookies to understand how you use our site and to improve your overall experience. By continuing to use our site, you accept our Privacy Policy. More information