Build a custom Docker image

Uses: Kong Gateway

Incompatible with

konnect

Prerequisites

Download the Kong Gateway entry-point script.

Download the Kong Gateway entry-point script:

 curl -O https://raw.githubusercontent.com/Kong/docker-kong/master/docker-entrypoint.sh

Copied!

Make the script executable:
```
 chmod +x docker-entrypoint.sh
```
Copied!

Download the Kong Gateway base image

Download the image for your operating system.
Rename the file to either kong.deb or kong.rpm depending on the package.

Create a Dockerfile

Create a Dockerfile using any of the following templates:

cat <<EOF > Dockerfile
FROM debian:bookworm-slim
   
COPY kong.deb /tmp/kong.deb
   
RUN set -ex; \
    apt-get update \
    && apt-get install --yes /tmp/kong.deb \
    && rm -rf /var/lib/apt/lists/* \
    && rm -rf /tmp/kong.deb \
    && chown kong:0 /usr/local/bin/kong \
    && chown -R kong:0 /usr/local/kong \
    && ln -s /usr/local/openresty/luajit/bin/luajit /usr/local/bin/luajit \
    && ln -s /usr/local/openresty/luajit/bin/luajit /usr/local/bin/lua \
    && ln -s /usr/local/openresty/nginx/sbin/nginx /usr/local/bin/nginx \
    && kong version
   
   
COPY docker-entrypoint.sh /docker-entrypoint.sh
   
USER kong
   
ENTRYPOINT ["/docker-entrypoint.sh"]
   
EXPOSE 8000 8443 8001 8444 8002 8445 8003 8446 8004 8447
   
STOPSIGNAL SIGQUIT
   
HEALTHCHECK --interval=10s --timeout=10s --retries=10 CMD kong health
   
CMD ["kong", "docker-start"]
EOF

Copied!

cat <<EOF > Dockerfile
FROM registry.access.redhat.com/ubi9/ubi:9.5
   
COPY kong.rpm /tmp/kong.rpm
   
RUN set -ex; \
    yum install -y /tmp/kong.rpm \
    && rm /tmp/kong.rpm \
    && chown kong:0 /usr/local/bin/kong \
    && chown -R kong:0 /usr/local/kong \
    && ln -s /usr/local/openresty/luajit/bin/luajit /usr/local/bin/luajit \
    && ln -s /usr/local/openresty/luajit/bin/luajit /usr/local/bin/lua \
    && ln -s /usr/local/openresty/nginx/sbin/nginx /usr/local/bin/nginx \
    && kong version
   
COPY docker-entrypoint.sh /docker-entrypoint.sh
   
USER kong
   
ENTRYPOINT ["/docker-entrypoint.sh"]
   
EXPOSE 8000 8443 8001 8444 8002 8445 8003 8446 8004 8447
   
STOPSIGNAL SIGQUIT
   
HEALTHCHECK --interval=10s --timeout=10s --retries=10 CMD kong health
   
CMD ["kong", "docker-start"]
EOF

Copied!

cat <<EOF > Dockerfile
FROM ubuntu:24.04
   
COPY kong.deb /tmp/kong.deb
   
RUN set -ex; \
    apt-get update \
    && apt-get install --yes /tmp/kong.deb \
    && rm -rf /var/lib/apt/lists/* \
    && rm -rf /tmp/kong.deb \
    && chown kong:0 /usr/local/bin/kong \
    && chown -R kong:0 /usr/local/kong \
    && ln -s /usr/local/openresty/luajit/bin/luajit /usr/local/bin/luajit \
    && ln -s /usr/local/openresty/luajit/bin/luajit /usr/local/bin/lua \
    && ln -s /usr/local/openresty/nginx/sbin/nginx /usr/local/bin/nginx \
    && kong version
   
COPY docker-entrypoint.sh /docker-entrypoint.sh
   
USER kong
   
ENTRYPOINT ["/docker-entrypoint.sh"]
   
EXPOSE 8000 8443 8001 8444 8002 8445 8003 8446 8004 8447
   
STOPSIGNAL SIGQUIT
   
HEALTHCHECK --interval=10s --timeout=10s --retries=10 CMD kong health
   
CMD ["kong", "docker-start"]
EOF

Copied!

Build the image

Using the docker build command, you can build the image:

docker build --platform linux/amd64 --no-cache -t kong-image .

Copied!

Docker will build the image according to the parameters set in the Dockerfile.

Validate the image

Validate that the image was built correctly using docker run:

docker run -it --rm kong-image kong version

Copied!

If the image was built correctly, a Docker container will start and output the Kong Gateway Enterprise version to the console.

FAQs

What can I do with a Kong Gateway custom image?

You can use a custom image to specify certain settings, like custom ports or kong.conf parameters. This can be useful if your organization has certain requirements or other software that they use in conjunction with their API gateway. You can also use custom images in automation pipelines.

Build a custom Docker image

Prerequisites

Download the Kong Gateway entry-point script.

Download the Kong Gateway base image

Create a Dockerfile

Build the image

Validate the image

FAQs

Help us make these docs great!

Still need help