README.md

Kong in Docker Compose

This is the official Docker Compose template for Kong.

What is Kong?

You can find the official Docker distribution for Kong at https://store.docker.com/images/kong.

How to use this template

This Docker Compose template provisions a Kong container with a Postgres database, plus a nginx load-balancer and Consul for service discovery. After running the template, the nginx-lb load-balancer will be the entrypoint to Kong.

To run this template execute:

$ docker-compose up

To scale Kong (ie, to three instances) execute:

$ docker-compose scale kong=3

Kong will be available through the nginx-lb instance on port 8000, 8443 and 8001. You can customize the template with your own environment variables or datastore configuration.

Kong's documentation can be found at getkong.org/docs.

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.