aux-duckdb

Prebuilt DuckDB bundles for Ducklake with Postgres.

This repository builds DuckDB with the extensions statically linked into the DuckDB library, and packages the result as release assets.

Artifact Contract

Release assets are .tar.gz archives named:

aux-duckdb-ducklake-postgres-s3-v<duckdb-version>-<platform>.tar.gz

Supported platforms:

• linux-amd64
• linux-arm64
• macos-arm64

Each archive unpacks an opt/duckdb tree:

opt/duckdb/
  duckdb.h
  libduckdb.so or libduckdb.dylib

Dockerfiles extract the archive at /, so runtime files land under /opt/duckdb. Extension .duckdb_extension files are intentionally not packaged; the selected extensions are compiled into the DuckDB library to keep runtime images small and avoid extension downloads. The static archive is intentionally omitted.

Local Builds

just build-linux-amd64
just build-linux-arm64
just build-macos-arm64
just package-all

Linux builds run in Docker containers. macOS ARM64 builds run natively because Docker cannot produce a macOS dynamic library.

Release

After GitHub repository creation and authentication with gh:

just release 1.5.2

The release command creates or updates tag duckdb-v1.5.2 and uploads all matching artifacts.

CPU Baseline

Linux amd64 builds default to DUCKDB_X86_64_CPU_BASELINE=x86-64-v3 and DUCKDB_X86_64_CPU_TUNE=haswell. This enables the modern x86-64 feature set including AVX2/BMI/FMA and tunes code generation for a GCC-supported AVX2-era CPU target.

Use x86-64-v4 only when every target x86 host supports AVX-512.