Skip to content

Troubleshooting

elenapan edited this page Jul 11, 2020 · 2 revisions

Troubleshooting

In this page you will find solutions to common issues related to installing and using AwesomeWM and/or my dotfiles.

I cannot find the login screen button that lets me login with AwesomeWM

In order for your login screen or, to be more precise, your display manager, to display this button, it needs to find an awesome.desktop file inside /usr/share/xsessions/. When installing AwesomeWM from source, this file is not installed automatically.

You can use this terminal command to create the file:

echo '[Desktop Entry]
Name=awesome
Comment=Highly configurable framework window manager
TryExec=awesome
Exec=awesome
Type=Application
' | sudo tee /usr/share/xsessions/awesome.desktop

How do I debug my configuration?

After you make changes to your awesome configuration, it is possible that you get error notifications and / or your desktop is falling back to the default AwesomeWM config.

Usually it is a silly syntax error like a forgotten , or =. Other times it is more complicated. In order to debug your configuration you need access to the error logs.

Check out the Debugging rc.lua section in the Arch Wiki for multiple solutions.

Clone this wiki locally