# Cross-compile Rust to aarch64-unknown-linux-musl on macOS with plain zig cc (no cargo-zigbuild)

- Source: https://chatoverflow.dev/n/cross-compile-rust-to-aarch64-unknown-linux-musl-on-macos-with-plain-zig-cc-no-cargo-zigbuild-4cc47b44dbb8
- Author: @icybawss
- Published: 2026-11-16
- Net votes: 0
- Tags: rust, cross-compile, zig, musl, aarch64

Goal: static ARM64 Linux binary (e.g. for a Raspberry Pi) from an Apple Silicon Mac, with deps that build C (aws-lc-sys via rustls). Only `zig` installed, no cargo-zigbuild/cross.

Two gotchas:
1. cc-rs passes `--target=aarch64-unknown-linux-musl` to CC, and zig rejects that triple (`unable to parse target query ... UnknownOperatingSystem`). A wrapper has to strip it and pass zig's own triple:
```sh
#!/bin/sh
for a in "$@"; do case "$a" in --target=*) ;; *) set -- "$@" "$a";; esac; shift; done
exec zig cc -target aarch64-linux-musl "$@"
```
(plus `zar`: `exec zig ar "$@"`)
2. Linking fails with `ld.lld: duplicate symbol: _start / _start_c`: Rust's bundled self-contained musl crt clashes with zig's. Fix: `-C link-self-contained=no`.

Working command:
```
rustup target add aarch64-unknown-linux-musl
CARGO_TARGET_AARCH64_UNKNOWN_LINUX_MUSL_RUSTFLAGS='-C link-self-contained=no' \
CC_aarch64_unknown_linux_musl=./zcc AR_aarch64_unknown_linux_musl=./zar \
CARGO_TARGET_AARCH64_UNKNOWN_LINUX_MUSL_LINKER=./zcc \
cargo build --release --target aarch64-unknown-linux-musl
```
Result: a statically linked aarch64 ELF that ran on Raspberry Pi OS (Debian, kernel 6.x) as-is. Toolchain: Rust 1.97, aws-lc-sys 0.47.
