Overview/x-arm — aarch64
x-arm — X Linux for aarch64
equislinux/x-arm is the aarch64 overlay build of X Linux. It consumes
equislinux/x pinned to a commit, applies the
overlay/ delta and runs archiso to produce:
- a UEFI-only live ISO (
x-<version>-aarch64.iso) for real hardware and VMs; - an
[x]/aarch64pacman repository; - VM images for Apple Silicon (UTM/Parallels/VMware) and generic
virthosts.
Nothing in this repository modifies x, x-repo or web. The x86_64 profile
stays untouched: this is a separate tree on purpose, so an ARM change can never
be merged into main by accident.
Status
This is the first working iteration. Honest parity map:
| Area | State |
|---|---|
| archiso profile (UEFI/GRUB, arm64-efi) | done |
packages.aarch64 against Arch Linux ARM | done |
| Build pipeline (fetch → overlay → repo → ISO) | done |
[x] aarch64 repo (x-release, x-wallpapers, x-dev, xfetch, xtop) | done |
QEMU virt launcher and VM image export | done |
Installer parity (x-installer) | patch included, needs hardware test |
xgen/xkernel (Image, no pkgbase) | delta implemented in scripts-arm (x-scripts-arm); VM/hardware validation pending |
| Desktop (Hyprland/niri) inside a VM | Hyprland + equisdots shell verified in UTM (quickshell 0.3.2 from ALARM); niri untested |
| CI | static checks only; the ISO build needs an aarch64 host |
| Secure Boot, Raspberry Pi, Asahi, ARMv7 | out of scope |
ARM desktop fixes (Hyprland)
The shared scripts/tools/hyprland-install.sh (x-scripts) is x86_64-oriented.
The overlay adds an ARM-only wrapper (airootfs/usr/local/bin/x-hyprland-arm)
that the installer invokes instead; the shared repositories stay untouched:
quickshellandswayosdship in ALARMextra, so the wrapper installs them as official packages and never builds the AUR-gitversions (yay +quickshell-gitruns out of memory on a 4 GiB VM). Existingquickshell-git/swayosd-gitproviders are detected and respected, so the official pair never conflicts.- The
OFFICIALpackage list is filtered against the ALARM databases before the transaction runs (rofi-emojiis not in ALARM and used to abort the whole install);pacman -Syruns first because the live database ages and mirrors prune old package versions (404s on poppler/kirigami-addons). - The live/target
pacman.confenablesDisableDownloadTimeoutand the mirrorlist only lists resolvable hosts (de.mirrorfirst, geo as fallback; theus./ca.subdomains no longer exist). - The equisdots plugin SDK (
core/sdk/PluginHost.qml) is only shipped by the online equisdots payload; the vendored offline snapshot lacks it, so online mode is the working desktop path. - Hyprland 0.57 caps
decoration.shadow.render_powerat 4 while the equisdots settings ship 5 (every session shows a config-error banner): the wrapper clamps it to 4. - On a virtual GPU (virtio-gpu/virgl, e.g. UTM/QEMU) the wrapper also
disables the equisdots
Floatingoverlay (it renders opaque and covers the whole desktop) and installs a~/.local/bin/kittyshim exportingLIBGL_ALWAYS_SOFTWARE=1(virgl exposes GLES only, kitty needs desktop GL). Both are scoped tovirtio_gpu; real hardware keeps the stock stack.
Requirements
Build host: aarch64 Arch Linux ARM, root, ~15 GiB free. On a MacBook this means an Arch Linux ARM VM in UTM (see Build). The Docker builder runs the same pipeline inside an Arch Linux ARM container on any Docker host (see Docker builder).
pacman -S --needed base-devel git grub squashfs-tools libisoburn libarchive \
dosfstools mtools erofs-utils mkinitcpio-archiso systemd-ukify \
arch-install-scripts rsync qemu-img qemu-system-aarch64 jq gnupg
archiso is not packaged in ALARM; scripts/fetch-archiso.sh clones upstream
archiso, which already supports aarch64 (grub_target=arm64-efi,
BOOTAA64.EFI).
Quick start
# 1. resolve inputs
scripts/fetch-x.sh
scripts/fetch-archiso.sh
# 2. overlay onto the pinned x checkout
scripts/apply-overlay.sh
# 3. build the [x]/aarch64 repo (normal user), then the ISO (root)
X_REPO_SIGN_KEY=... scripts/build-repo.sh --sign
sudo scripts/build-iso.sh
# 4. boot it locally (QEMU) or install into a VM disk
scripts/vm.sh --iso out/iso/x-*-aarch64.iso --disk out/vm/x-aarch64.qcow2
build-iso.sh --no-repo uses the published [x]/aarch64 URL instead of the
local repo (only valid after a release).
Layout
vendor/x.sha pinned commit of equislinux/x
vendor/archiso.sha pinned commit of archlinux/archiso
overlay/ the ARM-only delta
profiledef.sh
packages.aarch64
pacman.aarch64.conf.in
airootfs/ live system overrides (pacman, keyring, presets)
grub/ GRUB config for /boot/Image
patches/ patches applied to vendor/x
packages/ aarch64 build overrides for [x] packages
scripts/ fetch, overlay, build, VM, publish
vm/ UTM/QEMU notes and bundle helpers
docker/ pinned ALARM rootfs and builder container
prepare/ candidate patches for upstream repositories
docs/ es/ and en/ build docs, acceptance criteria
Design rules
x,x-repoandwebare consumed read-only; the only writes are inx-arm/out(gitignored).- The overlay is applied on a clean checkout every time, so builds are reproducible and a stale file can never leak in.
- No ISOs,
.qcow2,.rawor.utmbundles in git; they go to SourceForge. - x86_64 behaviour is untouched by construction.
See Build for the full flow, Docker builder for container builds, VM images for UTM/QEMU, Acceptance for the exit criteria of a release and Candidate patches for the drafts aimed at upstream repositories.