Building the ISO

Jump to bottom

madkoding edited this page Mar 5, 2026 · 1 revision

Building the ISO

Requirements

Arch Linux or Arch-based system
archiso package
~10GB free disk space
Root access

Local Build

# Install archiso
sudo pacman -S archiso

# Build the ISO
sudo mkarchiso -v -w work/ -o out/ .

# Output location
ls -lh out/madOS-*.iso

Build time: ~10-20 minutes

GitHub Actions

ISO builds automatically on push to main:

Push to main branch
Monitor build in GitHub Actions tab (~15 minutes)
Download ISO from Artifacts