Guides
arm64 migration checklist
You want to move to arm64 without breaking the pipeline.
5 min read
You want to move to arm64 without breaking the pipeline.
Why it happens
Most failures come from transitive native dependencies rather than from your own code.
How to fix it
- Audit native modules and confirm aarch64 wheels or prebuilds exist
- Check base images have arm64 variants
- Search the codebase for x86 intrinsics or inline assembly
- Run both architectures in parallel for a week before dropping x64
Your next build could be twice as fast, at half the price
Start free. Migrating away is the same one line, and we publish that diff too.
Related
How to move CI to arm64 runnersYou deploy to Graviton or Ampere but build on x64.Cross-compiling versus native arm64You need arm64 binaries and are unsure whether to cross-compile or build natively.Why QEMU arm64 builds are so slowAdding linux/arm64 to a Docker build makes it twenty times slower.Fixing Node native modules on arm64npm install fails or compiles from source on arm64 runners.