🔧

Troubleshooting

Diagnose and fix common problems — boot issues, drivers, connectivity, and crashes.

Frequently Asked Questions

G4 OS will not boot after installation — what should I do? +

Boot from the USB installer and select "Repair G4 OS". This runs a boot repair tool that fixes corrupted GRUB and missing EFI entries. If the issue persists, contact support with the error message.

My screen is blank or flickering after boot. +

At the GRUB menu, press E and add nomodeset to the kernel line to start in compatibility graphics mode. Once booted, go to Settings → Display → Graphics → Install recommended driver.

Wi-Fi is not working after installation. +

Open Settings → Hardware → Network Adapters → Scan for Drivers. If your adapter is not found, connect via Ethernet, then run: sudo g4-driver-manager --wifi from a terminal.

An application crashes immediately on launch. +

Try launching from a terminal to see error output. Check for updates in the App Store. If the issue persists, clear the app cache: Settings → Apps → [App Name] → Clear Cache.

G4 OS is running slowly or feels sluggish. +

Check resource usage in Settings → System Monitor. Common causes: insufficient RAM, a slow HDD, or heavy AI workloads in the background. Enable Game Mode for performance-critical tasks.

How do I report a bug? +

Use the built-in feedback tool: Settings → Help → Report a Bug. Include a description, steps to reproduce, and attach the system log (Settings → Help → System Log).

💬