Skip to content

Velox Jar Setup

This page documents the Apache Gluten release tarball and extracted Velox bundle jar used by docker/velox/Dockerfile.

Docker build flow

The checked-in Dockerfile downloads the official Apache Gluten Spark 4.0 release tarball, verifies the published .sha512, then extracts the bundled Velox jar.

Build the image like this (run from the project root):

Terminal window
docker build \
--platform linux/amd64 \
-f docker/velox/Dockerfile \
-t benchbox-velox:dev .

As of Apache Gluten 1.6.0, the official Spark 4.0 release tarball contains an amd64 jar only. The provided Dockerfile therefore targets linux/amd64.

Manual verification

Terminal window
curl -fsSLO https://downloads.apache.org/gluten/1.6.0/apache-gluten-1.6.0-bin-spark-4.0.tar.gz
curl -fsSLO https://downloads.apache.org/gluten/1.6.0/apache-gluten-1.6.0-bin-spark-4.0.tar.gz.sha512
sha512sum -c apache-gluten-1.6.0-bin-spark-4.0.tar.gz.sha512
tar -xzf apache-gluten-1.6.0-bin-spark-4.0.tar.gz \
gluten-velox-bundle-spark4.0_2.13-linux_amd64-1.6.0.jar

If you want a local hash for an extracted jar, compute it after extraction:

Terminal window
sha256sum gluten-velox-bundle-spark4.0_2.13-linux_amd64-1.6.0.jar

Note: Gluten graduated from the Apache Incubator in March 2026. Current releases are published under downloads.apache.org/gluten/. Historical incubating releases used downloads.apache.org/incubator/gluten/ and different version-directory naming.

Known versions

VersionSparkArchitectureRelease tarballExtracted jarNotes
1.6.04.0amd64apache-gluten-1.6.0-bin-spark-4.0.tar.gzgluten-velox-bundle-spark4.0_2.13-linux_amd64-1.6.0.jarDockerfile verifies the published tarball .sha512 before extraction

As of April 2026, Apache Gluten does not publish an official aarch64 jar in the Spark 4.0 release tarball. Arm64 users need a self-built jar or another custom artifact source outside the default BenchBox Docker workflow.