Build Your Own Docker Images

Learn how to build custom Docker images for Apache APISIX, allowing for tailored configurations to meet your specific deployment needs.

You can build your own Docker images and customize them for your needs.

Prerequisite(s)

Install make to build your Docker image from the makefile.

Clone Repository

Clone the repository and navigate into it:

git clone https://github.com/apache/apisix-docker.git
cd apisix-docker

Build a Docker Image

Build a Docker image from a release:

APISIX_VERSION=3.18.0       # specify a release version
DISTRO=ubuntu              # ubuntu, debian, centos, or redhat
make build-on-$DISTRO

The make command builds a Docker image tagged as apache/apisix:${APISIX_VERSION}-${DISTRO} with the corresponding Dockerfile in the repository, such as ubuntu/Dockerfile. You can further customize the relevant files for your needs.

Check Docker Image

List all Docker images:

docker images

You should see the list including the image built in the last step:

REPOSITORY     TAG            IMAGE ID       CREATED              SIZE
apache/apisix  3.18.0-ubuntu   422e111797f3   About a minute ago   337MB