GitHub

Troubleshooting

Common issues and solutions for LevitateOS installation and usage.

Boot Issues

System fails to boot

Boot from the ISO again and verify your installation:

Mount your partitions 
mount /dev/sda2 /mnt
mount /dev/sda1 /mnt/boot
Verify root partition is labeled 'root' (required for UKI) 
blkid /dev/sda2 | grep 'LABEL="root"'
Verify UKI exists 
ls -la /mnt/boot/EFI/Linux/levitateos.efi
Reinstall UKI if missing 
mkdir -p /mnt/boot/EFI/Linux
cp /media/cdrom/boot/uki/levitateos.efi /mnt/boot/EFI/Linux/
Re-enter chroot and reinstall bootloader 
recchroot /mnt
bootctl install
exit

Bootloader not found (UEFI)

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

Network Issues

No network after reboot

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"

WiFi adapter not detected

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.

Package Issues

Package installation fails

Try updating the package database first:

Update package lists 
recipe update
Retry installation 
recipe install packagename