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:

1. import dashboard id: 16098 for server status
2. 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.

Before you start to code, we recommend discussing your plans through a GitHub issue, especially for more ambitious contributions. This gives other contributors a chance to point you in the right direction, give you feedback on your design, and help you find out if someone else is working on the same thing.