Skip to content

docs: use cargo-zigbuild for aarch64 cross-compilation #43

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
madeye merged 1 commit into from
Jun 14, 2026
Merged

docs: use cargo-zigbuild for aarch64 cross-compilation #43

Changes from all commits
Commits
Show all changes
1 commit
Select commit
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
10 changes: 6 additions & 4 deletions CLAUDE.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -9,9 +9,11 @@ Transparent TCP proxy that intercepts traffic via OS firewall rules and forwards
cargo build --release

# Cross-compile for Linux aarch64 (e.g., Raspberry Pi)
# Requires: cargo install cross
# Must run from a path Docker can mount (e.g., ~/workspace, NOT /Volumes/)
cross build --release --target aarch64-unknown-linux-gnu
# Requires: cargo install cargo-zigbuild (+ a Zig toolchain: brew install zig)
# rustup target add aarch64-unknown-linux-gnu
# No Docker needed, so this works from any path (including /Volumes/...).
# The glibc suffix (.2.31) pins the target ABI; 2.31 covers Pi OS bullseye/bookworm.
cargo zigbuild --release --target aarch64-unknown-linux-gnu.2.31
# Binary at: target/aarch64-unknown-linux-gnu/release/trans_proxy
```

Expand All @@ -36,7 +38,7 @@ docker run --rm --privileged trans_proxy_test /app/target/release/e2e
## Deploy to remote Linux host

```bash
cross build --release --target aarch64-unknown-linux-gnu
cargo zigbuild --release --target aarch64-unknown-linux-gnu.2.31
scp target/aarch64-unknown-linux-gnu/release/trans_proxy user@host:/tmp/trans_proxy
ssh user@host "sudo systemctl stop trans_proxy && sudo cp /tmp/trans_proxy /usr/local/bin/trans_proxy && sudo chmod 755 /usr/local/bin/trans_proxy && sudo systemctl start trans_proxy"
```
Expand Down
Loading