Build Your Own Docker Images

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.16.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.16.0-ubuntu   422e111797f3   About a minute ago   337MB