Crystal Platform Support

The Crystal compiler runs on, and compiles to, a great number of platforms, though not all platforms are equally supported. Crystal’s support levels are organized into three tiers, each with a different set of guarantees.

Platforms are identified by their “target triple” which is the string to inform the compiler what kind of output should be produced. The columns below indicate whether the corresponding component works on the specified platform.


Tier 1

Tier 1 platforms can be thought of as “guaranteed to work”. Specifically they will each satisfy the following requirements:

  • Official binary releases are provided for the platform.
  • Automated testing is set up to run tests for the platform.
  • Documentation for how to use and how to build the platform is available.
TargetCompilerStdDescription
x86_64-darwin64-bit OSX (10.7+, Lion+)
x86_64-linux-gnu64-bit Linux (kernel 2.6.18+, GNU libc)

Tier 2

Tier 2 platforms can be thought of as “expected to build”. Automated tests are not run so it’s not guaranteed to produce a working build, but platforms often work to quite a good degree and patches are always welcome!

TargetCompilerStdDescription
aarch64-darwinARM 64-bit OSX (Apple Silicon)
aarch64-linux-gnuARM 64-bit Linux (GNU libc, hardfloat)
aarch64-linux-muslARM 64-bit Linux (MUSL libc, hardfloat)
arm-linux-gnueabihfARM 32-bit Linux (GNU libc, hardfloat)
i386-linux-gnu32-bit Linux (kernel 2.6.18+, GNU libc)
i386-linux-musl32-bit Linux (MUSL libc)
x86_64-linux-musl64-bit Linux (MUSL libc)
x86_64-openbsd64-bit OpenBSD (6.x)
x86_64-freebsd64-bit FreeBSD (11.x)

Tier 3

Tier 3 platforms are those which the Crystal codebase has some sort of support for, but which are not built or tested automatically, and may not work. Official builds are not available.

TargetCompilerStdDescription
x86_64-windows-msvc64-bit MSVC (Windows 7+)
x86_64-unknown-dragonfly64-bit DragonFlyBSD
x86_64-unknown-netbsd64-bit NetBSD
wasm32-unknown-wasiWebAssembly (WASI libc)

Note: big thanks go to the Rust team for putting together such a clear doc on Rust’s platform support. We felt it was so close to what we were needing in Crystal, that we basically copied many chunks of their document. See https://forge.rust-lang.org/platform-support.html.