Edit this page

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.

Download KrakenD and Generate the configuration file

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

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

docker pull devopsfaith/krakend
docker run -p 8080:8080 -v $PWD:/etc/krakend/ devopsfaith/krakend run --config /etc/krakend/krakend.json

Make sure you have a krakend.json in the current directory with your endpoint definition. You can generate it here

Mac OS X

The Homebrew formula will download the source code, build the formula and link the binary for you.

brew install 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:

rpm -Uvh http://repo.krakend.io/rpm/krakend-repo-0.1-0.noarch.rpm
yum install -y krakend
systemctl start krakend

Fedora

Paste this in the terminal:

rpm -Uvh http://repo.krakend.io/rpm/krakend-repo-0.1-0.noarch.rpm
dnf install -y krakend
systemctl start krakend

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:

apt-key adv --keyserver keyserver.ubuntu.com --recv AB39BEA1
echo "deb http://repo.krakend.io/apt stable main" | tee /etc/apt/sources.list.d/krakend.list
apt-get update
apt-get install -y krakend

Current KrakenD version will run at least in Debian 8, Debian 9 and Ubuntu 16.x

Generic (via tar.gz)

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

Build KrakenD yourself

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!