docs(docker): hint on BuildKit being required

camunda · Nov 22, 2022 · cb7c21a · cb7c21a
1 parent 8a0ae7c
commit cb7c21a
Show file tree

Hide file tree

Showing 2 changed files with 12 additions and 0 deletions.
diff --git a/Dockerfile b/Dockerfile
@@ -1,3 +1,6 @@
+# This Dockerfile requires BuildKit to be enabled, by setting the environment variable
+# DOCKER_BUILDKIT=1
+# see https://docs.docker.com/build/buildkit/#getting-started
 ARG BASE_DIGEST_AMD64="sha256:00a5775f5eb7c24a19cb76ded742cbfcc50c61f062105af9730dadde217e4390"
 ARG BASE_DIGEST_ARM64="sha256:ce46be0c4b4edd9f519e99ad68a6b5765abe577fbf1662d8ad2550838eb29823"
 

diff --git a/docs/building_docker_images.md b/docs/building_docker_images.md
@@ -21,6 +21,15 @@ mvn dependency:copy -B \
     -Dmdep.stripVersion=true
 ```
 
+## Make sure BuildKit is enabled
+
+The Dockerfile for Zeebe requires [BuildKit](https://docs.docker.com/build/buildkit/#getting-started),
+which is enabled by default if Docker Desktop is installed.
+On Linux you may need to enable it explictly by setting the environment variable
+```bash
+DOCKER_BUILDKIT=1
+```
+
 ## Build the Image
 
 Now build the image for your local platform (supported for AMD64 and ARM64):