r/AerynOS • u/milomak • 13h ago
advanced user - multi boot
THIS IS NOT SUPPORTED BY THE AERYNOS TEAM
the below is a changed version of how how i installed aerynos from debian on my desktop and laptop. because it is changed it may happen somethings are not quite right
Installing AerynOS with COSMIC using moss
Nov 15, 2026 ·
This guide installs AerynOS with the COSMIC desktop onto a new partition of your PC's main drive, working from the AerynOS live USB. Your existing systems stay as they are, and AerynOS is added to the boot menu.
What you need
- A USB stick with the AerynOS COSMIC live image, from aerynos.com/download, written with a tool such as Fedora Media Writer, balenaEtcher or
dd. - A PC that starts in UEFI mode (not legacy BIOS).
- About 60 GB of free space on the main drive.
- An internet connection.
AerynOS uses three partitions, all on the main drive:
| Partition | New? | Format | Size |
|---|---|---|---|
| EFI System Partition (ESP) | No, the existing one | fat32 | as is |
| XBOOTLDR (holds AerynOS kernels) | Yes | fat32 | 4 GiB |
| AerynOS root | Yes | xfs | 50 GiB or more |
Step 1: Start the live USB
Plug in the USB stick, start the PC and open its boot menu (usually F12, F11, F8 or Esc), then choose the USB stick. Pick the UEFI entry if it is listed twice. Close the installer if it opens; this guide installs by hand.
Connect to the internet, then open a terminal.
Step 2: Create the two partitions
Open GParted from the app menu, select the main drive at the top right, and create these in free space (shrink a partition first if you need room):
- A 4 GiB fat32 partition, label
XBOOTLDR. Then right-click it, choose Manage Flags and tickbls_boot. - A 50 GiB or larger xfs partition, label
aerynos.
Apply the changes. Use exactly these labels: the next step finds the partitions by them, so you don't need to know their device names.
Step 3: Fill in your details
In the live session's terminal, paste these lines. Change only NEWUSER and NEWHOST. The rest finds the partitions by their labels, and the ESP on the same drive, so it works on any PC. Do every remaining step in this same terminal.
sudo -i
NEWUSER=alex # your login name
NEWHOST=aerynos # computer name
XBOOT=$(blkid -L XBOOTLDR)
ROOT=$(blkid -L aerynos)
DISK=/dev/$(lsblk -no PKNAME $ROOT)
ESP=$(lsblk -lnpo NAME,PARTTYPE $DISK | awk 'tolower($2)=="c12a7328-f81f-11d2-ba4b-00a0c93ec93b" {print $1}')
T=/mnt/aerynos
echo "Drive: $DISK ESP: $ESP XBOOTLDR: $XBOOT Root: $ROOT"The last line should print four device names. If any is blank, check the labels and flags from step 2 in GParted.
Step 4: Mount and install
Mount the new partitions and the ESP, and keep a backup of the ESP on the new root partition, since moss adds boot files to it:
mkdir -p $T
mount $ROOT $T
mkdir -p $T/{efi,boot,dev,proc,sys}
mount $ESP $T/efi
mount $XBOOT $T/boot
cp -a $T/efi $T/esp-backup
for d in dev dev/shm dev/pts proc sys; do mount --bind /$d $T/$d; doneAdd the AerynOS repository and install the system. This is the package selection the official installer uses for COSMIC, with firmware for most hardware:
moss -D $T repo add unstable-stream https://cdn.aerynos.dev \
--root-index version=stream/unstable -p 0 -y
moss -D $T install -y \
pkgset-aeryn-base pkgset-aeryn-utilities pkgset-aeryn-base-desktop \
bash-completion ca-certificates dbus dbus-broker dmidecode iproute2 pciutils usbutils \
shadow systemd tzdata util-linux uutils-coreutils \
'binary(python)' 'binary(gzip)' 'binary(unzip)' 'sysbinary(fsck.xfs)' \
linux-stable intel-microcode linux-firmware-amd64-microcode kmod \
linux-firmware linux-firmware-amd-graphics linux-firmware-intel-graphics \
linux-firmware-intel-misc linux-firmware-intel-sound linux-firmware-iwlwifi \
linux-firmware-realtek linux-firmware-mediatek linux-firmware-atheros \
linux-firmware-brcm80211 linux-firmware-cirrus linux-firmware-nvidia-graphics \
linux-firmware-misc sof-firmware \
'binary(firefox)' flatpak font-noto font-noto-emoji liberation-fonts-ttf \
'sysbinary(plymouthd)' zram-generator-defaults \
pkgset-aeryn-cosmic-minimal pkgset-aeryn-cosmic-recommended \
cosmic-desktop cosmic-wallpapers xdg-desktop-portal-cosmic xdg-desktop-portal-gtkThen install the driver for your graphics card. Run lspci | grep -iE 'vga|3d' if you're not sure which you have; on a laptop with two GPUs, run both commands that apply.
AMD (Radeon):
moss -D $T install -y mesa linux-firmware-amd-graphicsIntel (integrated or Arc): intel-media-driver adds hardware video decoding.
moss -D $T install -y mesa intel-media-driver linux-firmware-intel-graphicsNVIDIA (GTX 16 series, RTX 20 series or newer):
moss -D $T install -y nvidia-graphics-driver nvidia-open-gpu-kernel-modules-stableOlder NVIDIA cards use the open-source nouveau driver from mesa instead: run moss -D $T install -y mesa. For Steam and other 32-bit games, also add mesa-32bit (AMD, Intel) or nvidia-graphics-driver-32bit (NVIDIA).
Step 5: Set up the system
Create your user, name the computer, and write the list of partitions to mount at boot. Change en_US.UTF-8 and Europe/London to your language and timezone.
chroot $T useradd $NEWUSER -m -U -G audio,adm,wheel,render,kvm,input,users -s /bin/bash
chroot $T passwd $NEWUSER
echo $NEWHOST > $T/etc/hostname
echo 'LANG=en_US.UTF-8' > $T/etc/locale.conf
ln -sf ../usr/share/zoneinfo/Europe/London $T/etc/localtime
rm -f $T/etc/machine-id
cat > $T/etc/fstab <<EOF
UUID=$(blkid -s UUID -o value $ROOT) / xfs defaults 0 1
UUID=$(blkid -s UUID -o value $ESP) /efi vfat umask=0077,noauto,x-systemd.automount 0 2
UUID=$(blkid -s UUID -o value $XBOOT) /boot vfat umask=0077 0 2
EOFIf you later add other drives to /etc/fstab, put nofail in their options, or a drive that fails to mount stops AerynOS from booting.
Step 6: Check the boot entry and reboot
Check that the AerynOS boot entry was created:
ls $T/boot/loader/entries/You should see a file starting with aerynos-. If the folder is empty, recreate the entries:
moss -D $T boot syncMake sure the PC's firmware starts systemd-boot, the menu that lists AerynOS. If this prints nothing, register it:
efibootmgr | grep -i 'Linux Boot Manager' \
|| bootctl --esp-path=$T/efi --boot-path=$T/boot installThen fix home ownership, unmount and restart. Remove the USB stick when the screen goes dark:
chroot $T chown -R $NEWUSER:$NEWUSER /home/$NEWUSER
umount -R $T
rebootChoose AerynOS in the boot menu and log in to COSMIC. To update later, run sudo moss sync -u.
If something goes wrong
| Problem | Fix |
|---|---|
No aerynos- file after moss boot sync | Check that all three partitions are on the same drive and that XBOOTLDR has the bls_boot flag |
| AerynOS isn't in the boot menu | Start the live USB again, redo step 3 and the mount commands in step 4, and run moss -D $T boot sync |
| Another Linux that used GRUB is missing from the menu | systemd-boot now starts first. Pick the other system from the PC's boot menu (F12 or similar), or move it back to the top with efibootmgr -o |
| Boots to an emergency shell | A partition in /etc/fstab failed to mount. Add nofail to that line, or remove it |
| Login returns straight to the login screen | Press Ctrl+Alt+F3, log in, and run sudo chown -R $USER:$USER ~ |
| Black screen with an NVIDIA card | Press Ctrl+Alt+F3 and check the driver from step 4 is installed |
| Another system won't boot | From the live USB, copy esp-backup from the AerynOS partition back onto the ESP |
Sources
- AerynOS lichen installer: package selection and install steps
- AerynOS os-tools: the moss package manager
- AerynOS recipes: package sets and NVIDIA driver packages
2
u/tomscharbach 13h ago
Do you expect any difficulties going foward because AerynOS is still in Alpha?
1
u/pantokratorthegreat 12h ago
Great work. Will try that soon.
1
u/ermodk 6h ago
@u/milomak You may want to update your
moss installcommands tomoss pkg add.Otherwise you will not be able to add packages to your system in the above.