Kong in Docker Compose

Via the official Docker Compose template for Kong Gateway.

Note The Kong Docker Compose file uses the v3.9 compose schema; as such, it requires Docker Engine version 20.10.0+.

What is Kong?

Kong or Kong API Gateway is a cloud-native, platform-agnostic, scalable API Gateway distinguished for its high performance and extensibility via plugins.

Kong's Official documentation can be found at docs.konghq.com.
You can find the official Docker distribution for Kong on Docker Hub.

How to use this Compose file

$ docker compose --profile init up

This command will result in a single Kong Docker container:

$ docker compose ps
NAME                IMAGE               COMMAND                  SERVICE             CREATED              STATUS                        PORTS
kong-database        postgres:9.5        "docker-entrypoint.s…"   db                  About a minute ago   Up About a minute (healthy)   5432/tcp
kong-gateway      kong:latest         "/docker-entrypoint.…"   kong                About a minute ago   Up About a minute (healthy)   0.0.0.0:8000->8000/tcp, 127.0.0.1:8001->8001/tcp, 0.0.0.0:8443->8443/tcp, 127.0.0.1:8444->8444/tcp
kong-migrations     kong:latest         "/docker-entrypoint.…"   migrations          About a minute ago   Up About a minute (exited)
kong-migrations-up   kong:latest         "/docker-entrypoint.…"   migrations-up       About a minute ago   Up About a minute (exited)

You can delete the containers kong-migrations and kong-migrations-up after init completed.

If you change some config you can run:

$ docker compose up -d

This command will result in a single Kong Docker container:

$ docker compose ps
NAME                IMAGE               COMMAND                  SERVICE             CREATED              STATUS                        PORTS
kong-database        postgres:9.5        "docker-entrypoint.s…"   db                  About a minute ago   Up About a minute (healthy)   5432/tcp
kong-gateway      kong:latest         "/docker-entrypoint.…"   kong                About a minute ago   Up About a minute (healthy)   0.0.0.0:8000->8000/tcp, 127.0.0.1:8001->8001/tcp, 0.0.0.0:8443->8443/tcp, 127.0.0.1:8444->8444/tcp

Kong will be available on port 8000 and 8001. You can customize the template with your own environment variables or datastore configuration.

Grafana

default user:admin default password:admin

add dashboard:

import dashboard id: 16098 for server status
import dashboard id: 7424 for kong

Issues

If you have any problems with or questions about this image, please contact us through a GitHub issue.

Contributing

You are invited to contribute new features, fixes, or updates, large or small; we are always thrilled to receive pull requests, and do our best to process them as fast as we can.