Overview/x-arm — aarch64
Docker build environment (Arch Linux ARM, aarch64)
Builder container for the x-arm pipeline. It runs the pinned Arch Linux ARM
rootfs (rootfs.sha) with all the build dependencies installed, so the
aarch64 ISO can be produced on any Docker host (Apple Silicon runs it
natively).
docker/fetch-rootfs.sh # download + pin the ALARM rootfs (once)
docker/build-image.sh # import rootfs, build xlinux-arm-builder
Then run the normal pipeline inside the container:
docker/run.sh scripts/fetch-x.sh
docker/run.sh scripts/fetch-archiso.sh
docker/run.sh scripts/apply-overlay.sh
docker/run.sh scripts/build-repo.sh # normal user (makepkg)
docker/run.sh sudo scripts/build-iso.sh # root (mkarchiso)
docker/run.sh mounts the equislinux workspace at /workspace, so
vendor/, work/ and out/ are shared with the host. The container user is
remapped to the workspace owner.
Notes:
- The container is privileged:
mkarchisoneeds mounts and chroots. qemu-system-aarch64is deliberately not installed; runscripts/vm.shon the host (macOS:brew install qemuuses HVF acceleration).- The rootfs tarball is ~790 MB and lives in
docker/rootfs/(gitignored).
Signing keys
Signing stays out of git. Put the GPG homedir at
~/.config/equislinux/keys/gnupg (or point X_ARM_GNUPGHOME at it) and the
SourceForge SSH key in ~/.ssh. run.sh mounts both read-only and the
entrypoint copies them into /home/builder (fresh copy each run, avoids
virtiofs socket issues with gpg-agent).
Import the project key once — preferably on the host with a dedicated
GNUPGHOME, so the key never touches the container build cache:
GNUPGHOME=~/.config/equislinux/keys/gnupg gpg --import x-signing.asc
GNUPGHOME=~/.config/equislinux/keys/gnupg gpg --list-secret-keys --with-colons \
| awk -F: '/^sec/{print $5}'
Then sign and publish:
X_REPO_SIGN_KEY=<keyid> docker/run.sh scripts/build-repo.sh --sign
X_REPO_SIGN_KEY=<keyid> docker/run.sh scripts/publish-repo.sh --push
X_REPO_SIGN_KEY=<keyid> docker/run.sh scripts/publish-arm.sh --verify
For the ISO the [x] repo can be the published Pages URL
(docker/run.sh sudo scripts/build-iso.sh --no-repo), or rebuild the local
repo with --sign first.
See Build for the full flow and VM images for the QEMU launcher and UTM/Parallels/VMware import.