c-ludenberg
20a78051d6
- index/installer/launcher: release facts, SDDM theme (pixie on master), init/DE selectors, NoExtract for Install Artix entry - packages: branding pkg ships offline+online settings (no packagechooser.conf fallback), drop antergos-sddm-theme, correct repo index names - overlays/overlay-root/overlay-live: root-overlay is live-session only, real file trees, symlinked settings.conf, commit reference - desktop-environments/wallpapers: remove No Desktop option, video wallpaper via layan-theme + Smart Video Wallpaper Reborn - ci/development/building: three workflows incl. ai-moderator, IA upload disabled (if:false) - byode: new page documenting the SteamOS-inspired offline installer - AGENTS.md/openrc: OpenRC was an installer-only dinit conflict; manual rc-update add works
1.7 KiB
1.7 KiB
title, layout, nav_order, has_children
| title | layout | nav_order | has_children |
|---|---|---|---|
| Overlays | default | 12 | true |
Overlays
Two directories under iso-profiles/antergos/ control what goes into the ISO:
iso-profiles/antergos/
├── profile.yaml # Package lists, services, compression
├── root-overlay/ # → live rootfs — config for the live session
└── live-overlay/ # → live environment — installer configs and tools
How overlays work
- root-overlay files are merged into the live rootfs — the filesystem the ISO boots. Settings here (os-release, SDDM, wallpapers) affect the live session.
- live-overlay files are merged into the live environment on top. Calamares configs, the launcher desktop entries, and live-only tools live here.
- Neither is copied to the installed system. The Calamares online install builds the target system fresh from packages via
basestrap. Persistent configuration must ship as a package (antergos-release,antergos-layan-theme, etc.). - Overlays are self-contained (no symlinks to external directories) so the repo builds standalone.
Important: overlay behavior
Live-overlay files are copied via cp -LR in make_livefs(), not overlay-mounted. This means:
- You cannot hide a file from a package by placing an empty file in live-overlay — the package version still exists underneath
- To hide a desktop entry shipped by a package, use
NoExtractinpacman.conf.d/iso-x86_64.conf(this is how the Artix "Install Artix Linux" entry is suppressed) - To replace a file, your overlay version wins during copy
Related pages
- Root Overlay — live rootfs config, SDDM, wallpapers
- Live Overlay — installer configs, launcher, offline installer