kong api gateway with docker

KONG is an api gateway placed above the microservices aimed to managing the API and interactions external and internal with them in a more rational, efficient, safe and “easy” way, helping the developer in the separation between public and private API, improving their performance , facilitating monitoring etc …

Some Characteristic:

  • Built on NGINX
  • For the most part written in LUA
  • Expandable via many Plugins
  • It supports two types of Datastores, which can also be used simultaneously (Postgres, cassandra)
  • Platform Agnostic (available for debian/Ubunti, RedHat/Centos, Docker, AWS, Google Cloud and many more).


  • Easy management of API in a Microservice architecture
  • helps in the separation between Public and Private API
  • allows to measure and possibly limit the use of these API.
  • Improve performances (through the use of caching etc …)
  • Expandable through many plugins

The best way for move the firsts steps with KONG is using docker:

first, create an internal network for the containers:

docker network create kong-net

create a container for cassandra db:

docker run -d --name kong-cassandra-database \
--network=kong-net \
-p 9042:9042 \

create a postgre sql container:

docker run -d --name kong-postgres-database \
--network=kong-net \
-p 5432:5432 \
-e "POSTGRES_USER=kong" \
-e "POSTGRES_DB=kong" \

create a migration:

docker run --rm \
--network=kong-net \
-e "KONG_DATABASE=postgres" \
-e "KONG_PG_HOST=kong-postgres-database" \
-e "KONG_CASSANDRA_CONTACT_POINTS=kong-postgres-database" \
kong:latest kong migrations up

create a kong container connected to the postgres and cassandra databases throught the internal network kong-net:

docker run -d --name kong \
--network=kong-net \
-e "KONG_DATABASE=postgres" \
-e "KONG_PG_HOST=kong-postgres-database" \
-e "KONG_CASSANDRA_CONTACT_POINTS=kong-cassandra-database" \
-e "KONG_PROXY_ACCESS_LOG=/dev/stdout" \
-e "KONG_ADMIN_ACCESS_LOG=/dev/stdout" \
-e "KONG_PROXY_ERROR_LOG=/dev/stderr" \
-e "KONG_ADMIN_ERROR_LOG=/dev/stderr" \
-e "KONG_ADMIN_LISTEN=, ssl" \
-p 8000:8000 \
-p 8443:8443 \
-p 8001:8001 \
-p 8444:8444 \

check on url http://localhost:8001/

For more info, go on official web site here

Originally published here