LevitateOS

Documentation

Troubleshooting

Common issues and solutions for LevitateOS installation and usage.

Section

Boot Issues

WARNING

Default update model is A/B immutable (slot updates + rollback). Mutable mode is an explicit opt-in for daredevils, and is unsafe if you let an LLM author recipes without review.
Q /

System fails to boot

A /

Boot from the ISO again and verify your installation:

Mount your partitions 
mount /dev/sda2 /mnt
mount /dev/sda1 /mnt/boot
mount /dev/sda4 /mnt/var
Verify slot A partition is labeled 'system-a' 
blkid /dev/sda2 | grep 'LABEL="system-a"'
Verify slot A boot image exists 
ls -la /mnt/boot/EFI/Linux/levitateos-system-a.efi
Reinstall A/B boot images if missing 
mkdir -p /mnt/boot/EFI/Linux
cp /run/live-media/boot/uki/levitateos-system-a.efi /mnt/boot/EFI/Linux/
cp /run/live-media/boot/uki/levitateos-system-b.efi /mnt/boot/EFI/Linux/
Re-enter chroot and reinstall bootloader 
recchroot /mnt
bootctl install
exit
Q /

Bootloader not found (UEFI)

A /

Ensure you booted in UEFI mode and the ESP is mounted correctly:

Check if EFI variables are accessible 
ls /sys/firmware/efi/efivars
Verify ESP is mounted at /boot 
mount | grep boot

Section

Network Issues

Q /

No network after reboot

A /
Check NetworkManager status 
systemctl status NetworkManager
Start if not running 
sudo systemctl enable --now NetworkManager
Connect to WiFi 
nmcli device wifi connect "YourNetwork" password "YourPassword"
Q /

WiFi adapter not detected

A /

Check if the wireless driver is loaded:

List network interfaces 
ip link
Check for wireless devices 
nmcli device

If no wireless device appears, you may need to install additional firmware packages.

Section

Package Issues

Q /

Package installation fails

A /

Try updating the package database first:

Update package lists 
recipe update
Retry installation 
recipe install packagename