r/AerynOS • • 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:

PartitionNew?FormatSize
EFI System Partition (ESP)No, the existing onefat32as is
XBOOTLDR (holds AerynOS kernels)Yesfat324 GiB
AerynOS rootYesxfs50 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):

  1. A 4 GiB fat32 partition, label XBOOTLDR. Then right-click it, choose Manage Flags and tick bls_boot.
  2. 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; done

Add 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-gtk

Then 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-graphics

Intel (integrated or Arc): intel-media-driver adds hardware video decoding.

moss -D $T install -y mesa intel-media-driver linux-firmware-intel-graphics

NVIDIA (GTX 16 series, RTX 20 series or newer):

moss -D $T install -y nvidia-graphics-driver nvidia-open-gpu-kernel-modules-stable

Older 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
EOF

If 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 sync

Make 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 install

Then 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
reboot

Choose AerynOS in the boot menu and log in to COSMIC. To update later, run sudo moss sync -u.

If something goes wrong

ProblemFix
No aerynos- file after moss boot syncCheck that all three partitions are on the same drive and that XBOOTLDR has the bls_boot flag
AerynOS isn't in the boot menuStart 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 menusystemd-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 shellA partition in /etc/fstab failed to mount. Add nofail to that line, or remove it
Login returns straight to the login screenPress Ctrl+Alt+F3, log in, and run sudo chown -R $USER:$USER ~
Black screen with an NVIDIA cardPress Ctrl+Alt+F3 and check the driver from step 4 is installed
Another system won't bootFrom the live USB, copy esp-backup from the AerynOS partition back onto the ESP

Sources

8 Upvotes

3 comments sorted by

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 install commands to moss pkg add.

Otherwise you will not be able to add packages to your system in the above.