Docker: push multi platform architecture

Author: dannywillems

.github/workflows/docker.yaml

@@ -9,6 +9,7 @@ env:
 
 jobs:
   build-mina-node-image:
+    if: github.ref != 'refs/heads/develop' && !startsWith(github.ref, 'refs/tags/')
     timeout-minutes: 40
     strategy:
       matrix:
@@ -61,6 +62,7 @@ jobs:
 
   # Frontend
   build-mina-frontend-image:
+    if: github.ref != 'refs/heads/develop' && !startsWith(github.ref, 'refs/tags/')
     timeout-minutes: 5
     strategy:
       matrix:
@@ -112,12 +114,24 @@ jobs:
 
   # Push images to registry
   push-images:
-    runs-on: ubuntu-latest
+    strategy:
+      matrix:
+        arch:
+          - platform: linux/amd64
+            runs-on: ubuntu-latest
+          - platform: linux/arm64
+            runs-on: ubuntu-24.04-arm
+    runs-on: ${{ matrix.arch.runs-on }}
     if: github.ref == 'refs/heads/develop' || startsWith(github.ref, 'refs/tags/')
     steps:
       - name: Git checkout
         uses: actions/checkout@v5
 
+      # This is needed so that we can get the current version with vergen
+      - name: Fetch tag for current commit
+        run: |
+          git fetch --depth=1 origin +refs/tags/*:refs/tags/*
+
       - name: Login to Docker Hub
         uses: docker/login-action@v3
         with:

Makefile

@@ -291,7 +291,17 @@ docker-build-debugger: ## Build debugger Docker image
 
 .PHONY: docker-build-frontend
 docker-build-frontend: ## Build frontend Docker image
-	@docker build -t $(DOCKER_ORG)/mina-rust-frontend:$(GIT_COMMIT) frontend/
+	@ARCH=$$(uname -m); \
+	case $$ARCH in \
+		x86_64) PLATFORM="linux/amd64" ;; \
+		aarch64|arm64) PLATFORM="linux/arm64" ;; \
+		*) echo "Unsupported architecture: $$ARCH" && exit 1 ;; \
+	esac; \
+	echo "Building for platform: $$PLATFORM"; \
+	docker buildx build \
+		--platform $$PLATFORM \
+		--tag $(DOCKER_ORG)/mina-rust-frontend:$(GIT_COMMIT) \
+		frontend/
 
 .PHONY: docker-build-fuzzing
 docker-build-fuzzing: ## Build fuzzing Docker image
@@ -314,7 +324,17 @@ docker-build-light-focal: ## Build light focal Docker image
 
 .PHONY: docker-build-mina
 docker-build-mina: ## Build main Mina Docker image
-	@docker build -t $(DOCKER_ORG)/mina-rust:$(GIT_COMMIT) .
+	@ARCH=$$(uname -m); \
+	case $$ARCH in \
+		x86_64) PLATFORM="linux/amd64" ;; \
+		aarch64|arm64) PLATFORM="linux/arm64" ;; \
+		*) echo "Unsupported architecture: $$ARCH" && exit 1 ;; \
+	esac; \
+	echo "Building for platform: $$PLATFORM"; \
+	docker buildx build \
+		--platform $$PLATFORM \
+		--tag $(DOCKER_ORG)/mina-rust:$(GIT_COMMIT) \
+		.
 
 .PHONY: docker-build-mina-testing
 docker-build-mina-testing: ## Build Mina testing Docker image

website/docs/developers/docker-images.md

@@ -72,19 +72,52 @@ make docker-push-frontend
 
 ## Architecture Support
 
-Images are built for multiple architectures:
+All Docker images are built natively for multiple architectures to ensure
+optimal performance:
 
-- `linux/amd64` (x86_64)
-- `linux/arm64` (ARM64)
+- **`linux/amd64`** (x86_64) - For Intel/AMD processors
+- **`linux/arm64`** (ARM64) - For ARM processors (Apple Silicon, AWS Graviton,
+  etc.)
+
+### Automatic Architecture Selection
+
+Docker automatically pulls the correct architecture for your system:
+
+```bash
+# This automatically pulls the right architecture
+docker pull o1labs/mina-rust:latest
+
+# On Intel/AMD systems: gets linux/amd64
+# On Apple Silicon: gets linux/arm64
+# On ARM servers: gets linux/arm64
+```
+
+### Performance Benefits
+
+- **Native builds**: Each architecture is compiled natively for optimal
+  performance
+- **No emulation overhead**: ARM users get native performance instead of x86
+  emulation
+- **Faster startup**: Native images start faster than emulated ones
+
+### Verifying Architecture
+
+You can verify which architecture you're running:
+
+```bash
+docker run --rm o1labs/mina-rust:latest uname -m
+# x86_64 on Intel/AMD systems
+# aarch64 on ARM systems
+```
 
 ## Using Docker Images
 
 ### Running a Basic Node
 
 ```bash
 # Pull and run the main node
-docker pull o1labs/mina-rust:v1.4.2
-docker run -p 8302:8302 o1labs/mina-rust:v1.4.2
+docker pull o1labs/mina-rust:latest
+docker run -p 8302:8302 o1labs/mina-rust:latest
 ```
 
 ### Running with Frontend Dashboard
@@ -94,8 +127,8 @@ docker run -p 8302:8302 o1labs/mina-rust:v1.4.2
 # Download the latest release and use the provided docker-compose files
 
 # Or run containers separately
-docker run -d --name mina-node -p 8302:8302 o1labs/mina-rust:v1.4.2
-docker run -d --name mina-frontend -p 8070:8070 o1labs/mina-rust-frontend:v1.4.2
+docker run -d --name mina-node -p 8302:8302 o1labs/mina-rust:latest
+docker run -d --name mina-frontend -p 8070:8070 o1labs/mina-rust-frontend:latest
 ```
 
 For complete setup guides, see the