FAQ & Troubleshooting

General

Is Genesi OS free?

Yes — completely free and open source (GPL-3.0).

What is Genesi OS based on?

CachyOS (itself an optimized Arch Linux), using the CachyOS kernel with the BORE scheduler. Genesi adds AI Mode, a custom theme, and its own package set on top.

Does Genesi support Secure Boot?

Not yet — disable Secure Boot in your BIOS/UEFI before installing.

Can I run it in a VM?

Yes (VirtualBox, VMware, QEMU/KVM). Allocate at least 8 GB RAM and 4 cores for a smooth experience.

AI Mode

What is AI Mode?

A daemon (genesi-aid) that detects running AI workloads and tunes the system — CPU governor, swappiness, huge pages, process priority — then reverts when the workload ends. See AI Mode for the full picture.

How do I disable it?

sudo systemctl disable --now genesi-aid

Updates & Packages

How do I update?

sudo pacman -Syu

Can I install AUR packages?

Yes — paru is pre-installed:

paru -S package-name

Troubleshooting

Wi-Fi not working

lspci -k | grep -A 3 Network
sudo pacman -S linux-firmware
sudo reboot

AI Mode not activating

sudo systemctl status genesi-aid
sudo journalctl -u genesi-aid -f
sudo systemctl restart genesi-aid

System won't boot

Boot from the USB, then chroot in and repair the bootloader:

sudo mount /dev/sdXY /mnt
sudo arch-chroot /mnt
grub-install /dev/sdX
grub-mkconfig -o /boot/grub/grub.cfg
exit
sudo reboot