Boot-image compression
UFLinux ISO initramfs and signed modloop images use Zstandard level 19. Device disk images use Zstandard level 12 for the whole raw GPT image. SquashFS keeps 128 KiB blocks, which bounds per-block decompression memory, and XZ-specific BCJ filters are removed.
How it is wired up
Section titled “How it is wired up”The image builder installs the Zstandard compressor in its build root, without adding it as a
desktop dependency. It copies Alpine’s update-kernel into an image-only tools directory and
applies the locked compression patch, checking the patch checksum and requiring
CONFIG_RD_ZSTD=y and CONFIG_SQUASHFS_ZSTD=y in the selected kernel configuration before
proceeding.
All six supported architectures have both capabilities in Alpine’s linux-lts kernel APKs.
The architecture set was narrowed after the x86_64 image tests below; their recorded ISO hashes
and inventories remain historical evidence.
The image-only helper removes device firmware from the modloop before signing; the wireless
regulatory database stays there. Alpine’s mkinitfs still selects firmware for initramfs
drivers, and the live root includes Alpine’s full linux-firmware package collection. Devices
that need firmware before the live root is populated depend on the initramfs selection.
Your installed system is unaffected: Alpine’s installed helper and installed-system
mkinitfs settings are unchanged.
After ISO extraction, the builder checks the Zstandard frame magic, the SquashFS compressor
identifier and block size, and tests the complete initramfs stream. Results go to
checks/ARCH/compression.json, and the source and build inventories record the compression
policy and patch checksum.
What it measured
Section titled “What it measured”Two x86_64 development images with identical desktop packages and artwork, before and after the change, built on 8 November 2026. No application recompilation was needed — existing custom APKs were verified and signed with a new development key before assembly.
| Component | Previous gzip/XZ image | Zstandard image |
|---|---|---|
| Initramfs | 173.29 MiB | 159.71 MiB |
| Modloop | 289.78 MiB | 300.30 MiB |
| ISO | 945.00 MiB | 942.00 MiB |
The net ISO reduction is 3.00 MiB: the initramfs shrank, the modloop grew, and the total barely moved. These measurements do not establish a boot-time improvement or repeat-build reproducibility, and other architectures may have different size trade-offs.
Validation
Section titled “Validation”Recorded for the development image of 8 November 2026, whose taskbar was Ironbar — the current
tree has since replaced it with the in-repo uflinux-desktop shell. The x86_64 image passed
both BIOS and UEFI live boot, signed-modloop mounting, Ironbar
validation, XFS installation and reboot, and preservation of an unrelated partition. Installed
Settings, flyout, GTK authentication, TLP and ACPI tests passed at 512 MiB with one display, no
swap and no OOM. Network hwsim fixtures were not repeated.
Other architecture images have not been rebuilt or boot-tested for this change.
Derived from docs/compression.md inUFlinux-project/uflinux3(b4f4817). Report documentation problems inUFlinux-project/docs.