ExelentOS Troubleshooting Guide

This guide provides technical troubleshooting steps for common issues you might encounter while using ExelentOS. For advanced details, refer to the Arch Wiki.

tip: if you see anything encased in

this

it means you have to use a terminal(Ctrl+alt+t) unless otherwise noted

note: this is more technical, if there really is something you don’t understand, then create an issue on Github

Desktop Environment Issues

Desktop Environment Not Loading

Open a terminal with Ctrl + Alt + T or switch to a TTY with Ctrl + Alt + F2.
Log in and restart the display manager:
```
sudo systemctl restart sddm
```
If the issue persists, check the status of the display manager:
```
systemctl status sddm
```
Review logs for errors:
```
journalctl -xe | grep sddm
```

Driver and Hardware Issues

Graphics Drivers Not Working

Open a terminal with Ctrl + Alt + T.
Check installed drivers:
```
mhwd -li
```
List available drivers:
```
mhwd -l
```
Install the recommended driver:
```
sudo mhwd -a pci nonfree 0300
```
Reboot your system:
```
sudo reboot
```

Wi-Fi Not Connecting

Check Wi-Fi device status:
```
nmcli device
```
Restart the network service:
```
sudo systemctl restart NetworkManager
```

Reconnect to your Wi-Fi network:

nmcli device wifi list
nmcli device wifi connect <SSID> password <password>

Software and Package Management

Applications Not Launching

Verify the application is installed:
```
pacman -Q <application-name>
```
Reinstall the application:
```
sudo pacman -S <application-name>
```
Check application logs by running it in the terminal:
```
<application-name>
```

System Update Fails

Clear the package cache:
```
sudo pacman -Scc
```
Synchronize package databases:
```
sudo pacman -Syyu
```
If a keyring error occurs, refresh the keyring:
```
sudo pacman-key --refresh-keys
```

Display Issues

Resolution Not Detected

Identify connected monitors:
```
xrandr
```

Set the resolution manually:

xrandr --output <monitor-name> --mode <resolution>

Save changes by editing the configuration file:
```
nano ~/.xprofile
```
Add the xrandr command from step 2 and save.

Miscellaneous

Logs and Diagnostics

System logs:
```
journalctl -p 3 -xb
```
Boot issues:
```
journalctl -b
```
Hardware information:
```
lspci -v
```

Again, for detailed technical guidance, visit the Arch Wiki.