Files

T

c-ludenberg 9fe5174cc7 feat: add GitHub Pages docs site (Just the Docs), split packagechooser, disable IA upload

- docs/: new 13-page Jekyll site with Just the Docs theme
  - Home, Building, Installer, Packages, CI/CD, Development
  - Desktop Environments (with GNOME joke), Wallpapers, Launcher
  - Overlays, Root Overlay, Live Overlay
- .github/workflows/pages.yml: build & deploy docs from docs/ on
  push to master (only when docs/ changes)
- .github/workflows/build.yml: temporarily disable Internet Archive
  upload (if: false) until ISO is stable
- live-overlay/settings.conf: add instances section for init + desktop
  packagechooser instances
- live-overlay/modules/packagechooser_init.conf: init system selector
  (OpenRC, Runit, S6, Dinit) via netinstall-add method
- live-overlay/modules/packagechooser_desktop.conf: DE selector
  (Plasma, Xfce, Cinnamon, MATE, LXQt, i3, Sway, Hyprland + No Desktop)
  via legacy method
- README.md, AGENTS.md: fix sudo buildiso -> sudo ./buildiso, add note
  about system buildiso lacking --overwrite='*'
- .gitignore: add docs/_site/

2026-06-29 21:27:46 +02:00

1.6 KiB

Raw Blame History

title, layout, nav_order

title	layout	nav_order
Building	default	2

Building the ISO

Requires an Artix-based system with artools and squashfs-tools.

Prerequisites

pacman -S artools squashfs-tools
modprobe loop

Clone and configure

git clone https://github.com/Antergos-NeXT/antergos-iso.git
cd antergos-iso

export WORKSPACE_DIR="$PWD"

# Override pacman config with our repo (antergos-pkgs)
mkdir -p ~/.config/artools/pacman.conf.d
cp pacman.conf.d/iso-x86_64.conf ~/.config/artools/pacman.conf.d/

Build

sudo -E ./buildiso -p antergos

⚠️ Use ./buildiso, not buildiso. The Artix system /usr/bin/buildiso lacks the --overwrite='*' flag, causing file conflicts between calamares and calamares-branding-antergos-next (both claim /usr/share/calamares/branding/default/). Our repo's ./buildiso has it.

Output

The ISO appears in /var/lib/artools/buildiso/iso/antergos/.

First build pulls ~5 GB from the internet. Subsequent builds use pacman cache. Go make a coffee. Or two. Maybe three.

Environment variables

Variable	Purpose
`WORKSPACE_DIR`	Must point to repo root. `buildiso` looks for profiles under `$WORKSPACE_DIR/iso-profiles/`
`COMPRESSION`	Squashfs compression type (e.g. `zstd`). If unset, `mksquashfs` fails silently with a zero-size image

Custom packages repo

The ISO pulls branding, Calamares config, and wallpapers from our custom repo. To use it on your system:

[antergos-pkgs]
SigLevel = Optional TrustAll
Server = https://antergos-next.github.io/antergos-packages

1.6 KiB Raw Blame History