docker-minecraft-server/docs/misc/building.md

!!! tip "For advanced use only"

This page describes a capability that is not applicable to most users. It is only intended for rare cases when a very specific Java base image is needed or additional packages need to be installed that are not generally applicable or would bloat the image size.

Be sure to confirm that the desired [version and variant of Java isn't already provided](../versions/java.md).

Building image locally with alternate Java base

An alternate Java base image can be specified by setting the docker build argument BASE_IMAGE to the desired base image. The following shows an example of using the base image ghcr.io/graalvm/graalvm-ce:ol8-java11:

docker build --build-arg BASE_IMAGE=ghcr.io/graalvm/graalvm-ce:ol8-java11 -t IMG_PREFIX/minecraft-server:java11-graalvm .

Building a multi-architecture image

Ensure buildx/BuildKit support is enabled and run the following to build multi-architecture and push to the repository as named by the image:

docker buildx build --platform=linux/arm64 --platform=linux/arm/v7 --platform=linux/amd64 --tag IMG_PREFIX/minecraft-server --push .

To build for local images, multi-architecture is not supported, use the following with buildx to load the image into the local daemon:

docker buildx build --tag IMG_PREFIX/minecraft-server --load .

or just a plain build

docker build -t IMG_PREFIX/minecraft-server .

Installing extra packages

The following build args can be set to install additional packages for the respective base image distro:

• EXTRA_DEB_PACKAGES
• EXTRA_DNF_PACKAGES
• EXTRA_ALPINE_PACKAGES