Skip to main content
Depending on what platform or features you need, the build process may differ. After you’ve built a binary, running the test suite to confirm that the binary works as intended is a good next step. If you can reproduce a test failure, search for it in the Ant issue tracker or file a new issue.

Supported Platforms

Ant builds and runs on the following platforms. Official CI builds are produced for each platform listed below.
Operating SystemArchitecturesVariantStaticNotes
GNU/Linuxx64glibcNoUbuntu 22.04 (CI)
GNU/Linuxaarch64glibcNoUbuntu 22.04 (CI)
GNU/Linuxx64muslYesAlpine Edge (CI)
GNU/Linuxaarch64muslYesAlpine Edge (CI)
macOSx64opensslNomacOS 15 (CI)
macOSaarch64opensslNomacOS 15 (CI)
macOSx64mbedtlsNomacOS 15 (CI)
macOSaarch64mbedtlsNomacOS 15 (CI)
Windowsx64mingw/msysNoMSYS2 MINGW64 toolchain (CI)

Supported Toolchains

Ant is built with the GNU C23 standard (-std=gnu23). A compiler with C23 support is required.
Operating SystemCompiler Versions
LinuxGCC >= 14 or Clang >= 18
macOSXcode CLT (Apple Clang) or LLVM >= 18
WindowsMinGW-w64 GCC via MSYS2 (MINGW64)

Official Binary Platforms

CI binaries are produced using:
Binary packagePlatform and Toolchain
ant-linux-x64Ubuntu 22.04 (glibc), LLVM/Clang
ant-linux-aarch64Ubuntu 22.04 (glibc), LLVM/Clang
ant-linux-x64-muslAlpine Edge (musl), statically linked, Clang
ant-linux-aarch64-muslAlpine Edge (musl), statically linked, Clang
ant-darwin-x64macOS 15 Intel, LLVM/Clang
ant-darwin-aarch64macOS 15 ARM, LLVM/Clang
ant-darwin-x64-mbedtlsmacOS 15 Intel, LLVM/Clang, mbedTLS
ant-darwin-aarch64-mbedtlsmacOS 15 ARM, LLVM/Clang, mbedTLS
ant-windows-x64MSYS2 MINGW64 toolchain

Prerequisites

The following tools are required to build Ant regardless of platform:
  • C compiler with C23 support (GCC >= 14 or Clang >= 18)
  • Meson build system (and Ninja backend)
  • CMake (for the tlsuv subproject)
  • pkg-config
  • Node.js >= 22 (used to generate the JS snapshot at build time)
  • Rust toolchain (stable) with cargo (builds the OXC type-strip library)
  • Zig >= 0.15 (builds the package manager component)
  • Git

System Libraries

System libraries required:
  • OpenSSL (default) or mbedTLS (alternative TLS backend)
  • libsodium
  • libuuid (Linux/macOS)
  • llhttp (if not building from source via cmake)

Vendored Dependencies

The remaining dependencies are vendored as Meson subprojects under vendor/ and are fetched automatically:
  • libuv 1.52.0
  • yyjson 0.12.0
  • zlib-ng 2.3.3
  • nghttp2
  • pcre2
  • libffi
  • lmdb (OpenLDAP LMDB 0.9.33)
  • minicoro
  • argtable3
  • uthash
  • uuidv7
  • tlsuv (cmake subproject)

Next Steps

Choose your platform to get started:

Build docs developers (and LLMs) love