Files

T

docs: rework all pages to Artix Wiki quality

- 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

2026-07-11 23:33:17 +02:00

4.7 KiB

Raw Blame History

title, layout, nav_order

title	layout	nav_order
Installer	default	4

Calamares Installer

Antergos NeXT uses Calamares as its installer, with a custom launcher (calamares-next) that presents a mode picker before launching Calamares.

Modes

Mode	Description
Offline	Unpacks a pre-built KDE Plasma squashfs — no internet needed. Fast, deterministic, single option.
Online	Netinstall with init system choice + desktop selection. Downloads packages from the internet.

Fixed issues (v2026.07.11)

Audio on installed systems

The offline install works because pipewire.desktop is baked into the root squashfs via root-overlay. But in online mode, packages are installed fresh — and the upstream artix-pipewire-launcher doesn't support dinit. The XDG autostart entry was also missing.

Fix: The pipewire package in [antergos-pkgs] now includes pipewire.desktop installed to /etc/xdg/autostart/, and the artix-pipewire-launcher script is patched to recognize dinit (dinit|runit|s6) SUPPORT='YES'). This way both offline and online installs get working audio.

SDDM theme showing Breeze

KDE's SDDM KCM writes a kde_settings.conf with Current=breeze. The Antergos theme never took effect in the live session.

Fix: The antergos-sddm-theme package now ships theme.conf at /etc/sddm.conf.d/theme.conf with Current=antergos. SDDM reads conf.d files alphabetically, so theme.conf (reads after kde_settings.conf) wins.

`/usr/lib/os-release` showing "Artix Linux"

The filesystem package from Artix owns /usr/lib/os-release. Our antergos-release also needs to install there, but it wasn't included in the basestrap operations list.

Fix: Added antergos-release to the operations list in basestrap.conf so it's installed during bootstrapping with --overwrite.

Key differences from upstream Calamares

dracut/dracutlukscfg replaced with initcpiocfg/initcpio/luksopenswaphookcfg (Artix uses mkinitcpio, not dracut)
services-openrc module instead of services-systemd (supports all four inits via init-specific variants)
removeuser step removed, postcfg added
packagechooser module compiled in (upstream Calamares skips it by default)

Init system selector (online)

Users choose from: Dinit, OpenRC, Runit, S6.

Note: OpenRC is currently broken in Antergos NeXT — services don't enable correctly on installed systems. Choose Dinit (default), Runit, or S6 instead.

Implemented as a packagechooser instance with method: netinstall-add. The selected init pulls its associated packages (e.g. elogind-dinit, connman-dinit, sddm-dinit). The init packages are defined in netinstall.yaml as separate groups.

Dinit is preselected by default.

Desktop selector (online)

Users choose from: Plasma, Xfce, Cinnamon, MATE, LXQt, i3, Sway, Hyprland, or No Desktop.

Implemented as a separate packagechooser instance with method: legacy. "No Desktop" installs only the base system (TTY/login — no DE, no display manager).

Available desktops

Desktop	Artix Repo	Group/Packages	Notes
Plasma	world	`plasma` group	Default. Wayland + X11. Includes Discover
Xfce	galaxy	`xfce4` group
Cinnamon	galaxy	Individual packages
MATE	galaxy	`mate` + `mate-extra`
LXQt	galaxy	`lxqt` group
i3	world	`i3` group	Tiling WM
Sway	world	`sway` + related	Wayland-native tiling
Hyprland	world	`hyprland`	Wayland compositor

Not available

Budgie — not in any Artix repo (system, world, galaxy, lib32). Slideshow entries removed.
GNOME — dropped non-systemd support upstream. "You really think you can get GNOME here?"

Offline mode

No packagechooser. Uses unpackfs to deploy a pre-built KDE Plasma squashfs, then initcpiocfg + initcpio for mkinitcpio configuration.

Branding

Custom branding lives in the calamares-branding-antergos-next package, installed to /etc/calamares/branding/default/. The componentName in branding.desc must match its directory name — this is enforced by Calamares (see Branding.cpp).

Launcher

The calamares-next script (/usr/bin/calamares-next) handles the installer boot flow:

Mode picker — kdialog/zenity dialog asking Offline or Online install
Configuration — copies the appropriate settings.conf (offline or online) to /etc/calamares/settings.conf
Launch — runs calamares with the selected config

Launched via the desktop entry in the live session: Exec=sudo -E calamares-next.

4.7 KiB Raw Blame History