Troubleshooting

Start with the problem you have, then follow the link. If none of these fit, see Finding solutions and Reporting bugs.

First checks

Run these two commands first. They fix or explain many problems on their own.

Command	What it does
garuda-update	Updates the system and fixes known update problems. See Garuda Update
garuda-health	Checks the system and lists problems. garuda-health --fix repairs what it can. See Garuda Health

Updates and packages

Problem	Where to look
An update fails or stops with a conflict	Garuda Update and the update fixes
The system was updated only partly	Partial upgrades
An AUR package breaks the update	AUR packages
Downloads are slow	Increasing download speed
A program from Discover or PackageKit causes problems	Avoid PackageKit

Boot

Problem	Where to look
The system does not boot after an update	Boot a snapshot from the GRUB menu, then see Restoring snapshots
GRUB is missing or broken	Garuda Toolbox > Boot Repair, see Boot after a disk swap
The firmware boots another entry instead of Garuda	Why the Garuda bootloader
Secure Boot blocks Garuda	Secure Boot
The initramfs fails to build	Dracut

Hardware

Problem	Where to look
Graphics drivers are missing or wrong	Hardware Tool and hardware profiles
A laptop has two GPUs	Optimus devices
Sway does not start on NVIDIA	NVIDIA drivers on Sway
Tap to click does not work	Tap to click

Disk space and snapshots

Problem	Where to look
The disk is full	Prevent a full drive
You booted into a snapshot and want to keep it	Snapper Tools
Snapshots take too much space	snapper-support

Gaming

Problem	Where to look
A game stutters or runs slowly	Gaming optimizations
HDR does not work	HDR
FSR4 does not turn on	Upscaling