Zone Linux is a custom Arch Linux-based live ISO with an XFCE desktop themed around S.T.A.L.K.E.R.
Docker is the supported path on non-root hosts. The script builds the zone-builder
image, runs mkarchiso inside it, and restores ownership of the output.
./build.sh # use the repositories configured in pacman.conf
./build.sh --local-repos # use the workspace zone-*-repo checkouts
./build.sh --clean # remove the work directory first
./build.sh --no-cache # rebuild the builder imageThe ISO is written to zone-out/, together with a .sha256 checksum.
Requires a current Arch Linux host with archiso installed and root access:
sudo ./build.sh --native --local-repos./flash.sh # interactive, USB-only device list
sudo dd if=zone-out/zone-*.iso of=/dev/sdX bs=4M status=progress oflag=syncReplace /dev/sdX with the target device (check with lsblk).
./test.sh --bios --verify
./test.sh --uefi --verify
./test.sh --headless --timeout 180The ISO ships Plymouth with four Zone themes (zone-mark, zone-anomaly,
zone-pda, zone-sector) from zone-plymouth-theme. All four are embedded in
the initramfs and one is chosen per boot from the kernel random UUID mixed with
the boot time.
zone.splash=zone-pdaon the kernel command line forces a theme for that boot.zone-splash-theme <theme>(installed systems, as root) pins a theme and rebuilds the initramfs;zone-splash-theme randomrestores per-boot rotation.- The bootloader menu is unchanged; only the kernel command line carries
splash vt.global_cursor_default=0 plymouth.ignore-serial-consoles.
The saved boot entry needs splash for graphical mode. The live initramfs
enables the kms hook so BIOS systems have a framebuffer before the root
filesystem is mounted; UEFI systems can also use the firmware framebuffer.
plymouth.ignore-serial-consoles keeps the graphical splash on machines whose
kernel command line also contains a serial console, and headless serial tests
still work because the splash falls back to text mode when no framebuffer is
available.
.github/workflows/ci.yml has two jobs:
- profile runs on every push and pull request: bash syntax, shellcheck, profile consistency, boot entries and the package list.
- build runs on pushes to
masterand manual dispatches: it builds the ISO with the same Docker path as./build.sh, verifies the checksum and the boot-splash payload (boot entries,zone-splash, Plymouth and all four themes), then uploads the ISO and.sha256as a 7-day artifact.
Pull requests stop after the profile job: they do not run a privileged container build, and the 3.2 GB artifact is only useful for real builds.
The Zone freedesktop sound theme, zone-detector and the extended
startupsound ship in the zone-xfce package: the theme and all 16 OGG
assets land in /usr/share/sounds/zone, the scripts in /usr/bin, and the
detector unit in /etc/skel/.config/systemd/user. libcanberra is listed in
packages.x86_64 explicitly because the GTK module would otherwise only be a
transitive dependency of xfce4-settings.
- Add the package name to
archiso/packages.x86_64. - If the package ships executables in
airootfs/usr/local/bin/, add a"0:0:755"entry inprofiledef.sh'sfile_permissionsarray. - If it is a custom package, build it in
zone-pkgbuild/, publish it to the matchingzone-*-repo, and make surepacman.confreferences that repo.
| Path | Purpose |
|---|---|
archiso/ |
archiso profile (packages, hooks, configs, bootloaders) |
archiso/airootfs/ |
Files overlaid onto the live rootfs |
archiso/packages.x86_64 |
All packages installed in the live ISO |
archiso/efiboot/ |
systemd-boot entries (UEFI) |
archiso/syslinux/ |
syslinux entries (BIOS) |
docker/ |
Dockerfile for containerised builds |
.github/workflows/ci.yml |
Profile validation, ISO build, splash payload check |
.github/scripts/check-iso.sh |
Asserts boot entries and initramfs carry the splash |
build.sh |
Docker/native build wrapper |
zone-live-setup.service runs airootfs/usr/local/bin/zone-live-setup once at
boot. It replaces the deprecated archiso customize_airootfs.sh hook.
- archiso 92 bootmodes:
bios.syslinux+uefi.systemd-boot(old aliases removed) - Boot entries use
archisosearchuuidand a single initramfs (microcode embedded) mkinitcpio.conf.d/archiso.confreplaces the fullmkinitcpio.confoverride- No
/etc/mkinitcpio.d/linux.presetis shipped: mkinitcpio generates presets fromhook.preset, and a custom preset withALL_configwould disable themkinitcpio.conf.ddrop-ins (dropping thearchisohook and breaking boot) customize_airootfs.shreplaced byzone-live-setup.serviceudev/rules.d/98-zone-live-no-gpt-loop.rulessuppresses systemd's unused GPT auto-discovery loop attach on optical drives (noisy UEFI-only failure)- Accessibility/speech boot entry and
memtest86+EFI entry added - pacman.conf: defunct
[community]removed;CheckSpacedisabled for the chroot - packages: dead names replaced (
exa→eza,blueberry→blueman,ntfs-3g→ntfsprogs,nvidia→nvidia-open,gnu-netcat→openbsd-netcat);crda,reiserfsprogs,ueberzug,mplayer,broadcom-wl,ipw2100-fw,ipw2200-fwremoved - Legacy
installation-scripts/deleted;build.shis the single entry point
