euri-iso/docs/overlays.md

title, layout, nav_order, has_children

title	layout	nav_order	has_children
Overlays	default	12	true

Overlays

Two directories under iso-profiles/euri/ control what goes into the ISO:

iso-profiles/euri/
├── 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 (euri-release, euri-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 NoExtract in pacman.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