Debugging

This guide contains advice about debugging software issues with the components of the Librem 5 software stack and applications.

Reading the System Journal

Errors and warnings that are logged to the system journal can be read by running the journalctl tool as the root user, or using sudo. It can be useful to pass the -e option to skip to the end of the log, and specify -x to give context to messages in the log output:

sudo journalctl -xe

To see messages from a specific boot, pass the -b option with an offset that corresponds to the collection of messages for that boot. The collections are referenced chronologically using positive indices starting from 1, but they can also be referenced in reverse chronological order using negative indices starting from 0 and counting down for earlier boots.

For example, messages from the last recorded boot can be obtained with this command:

sudo journalctl -b 0

See the journalctl man page for detailed information about the different ways to access and format journals.