c-ludenberg
9fe5174cc7
- 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/
61 lines
1.6 KiB
Markdown
61 lines
1.6 KiB
Markdown
---
|
|
title: Building
|
|
layout: default
|
|
nav_order: 2
|
|
---
|
|
|
|
# Building the ISO
|
|
|
|
Requires an **Artix-based** system with `artools` and `squashfs-tools`.
|
|
|
|
## Prerequisites
|
|
|
|
```bash
|
|
pacman -S artools squashfs-tools
|
|
modprobe loop
|
|
```
|
|
|
|
## Clone and configure
|
|
|
|
```bash
|
|
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
|
|
|
|
```bash
|
|
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:
|
|
|
|
```ini
|
|
[antergos-pkgs]
|
|
SigLevel = Optional TrustAll
|
|
Server = https://antergos-next.github.io/antergos-packages
|
|
```
|