c-ludenberg
d0213a7a46
- index.md: add download link + stable release announcement - building.md: add troubleshooting section (cache, squashfs, compression) - ci.md: IA upload enabled, push trigger removed (manual dispatch only) - development.md: add all gotchas from AGENTS.md (SDDM theme ordering, pipewire launcher, antergos-release in basestrap, CI changes) - installer.md: document fixed issues (audio, SDDM, os-release) - packages.md: add pipewire fork, antergos-sddm-theme, antergos-release - launcher.md: expand with module configs - init-systems.md: Chimera uses dinit, OpenRC marked as broken - openrc.md: add broken warning banner - wallpapers.md: default is antergos-wallpaper.png (not Adwaita Morning) - overlays: clean up explanations and symlink behavior - desktop-environments.md: add Discover note, clean up GNOME entry - dinit.md, runit.md, s6.md: polish and add troubleshooting sections
1.5 KiB
1.5 KiB
title, layout, nav_order, has_children
| title | layout | nav_order | has_children |
|---|---|---|---|
| Overlays | default | 11 | 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/ # → rootfs (squashfs) — becomes part of installed system
└── live-overlay/ # → live environment only — not present after installation
How overlays work
- root-overlay files are merged into the root squashfs. Everything in here becomes part of the installed system — settings, wallpapers, autostart entries.
- live-overlay files are copied into the live environment only. They exist in the live session but are not present after installation. Calamares configs, the launcher desktop entry, and init-related configs live here.
- 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, use
NoDisplay=truein the.desktopfile - To replace a file, your live-overlay version wins during copy
Related pages
- Root Overlay — persistent system config, wallpapers, skel
- Live Overlay — installer configs, launcher, SDDM session