Skip to content

Troubleshooting

During your use of LineageOS, you may encounter some unexpected issues.

I can't do much about these unless appropriate logs are given.

(Please note that I will not assist if any modification is made to the ROM: For example, if a different kernel is flashed, if random Magisk modules are installed, or if the ROM is flashed with a different recovery).

Report an issue

To properly report an issue, the following logs must be provided:

  • logcat (System Log).
  • dmesg (Kernel Log).

Logcat

To grab a logcat it is required to have USB debugging enabled:

  • Go into Settings -> About Phone and press 7 times the Build Number.
  • Go into Settings -> System -> Developer options and enable USB Debugging.
  • Open an ADB & Fastboot tools window on your PC and run this:
    adb logcat -d > logcat.txt
  • If a radio buffer log is requested, run this too:
    adb logcat -db radio > radio.txt

Dmesg

Grabbing a dmesg requires root access. Fortunately, userdebug builds of LineageOS can access a root shell enviroment out-of-the box:

  • Go into Settings -> About Phone and press 7 times the Build Number.
  • Go into Settings -> System -> Developer options and enable USB Debugging and Rooted debugging.
  • Open a ADB & Fastboot tools window on your PC and run this:
    adb root # Enables root shell
    adb shell dmesg > /sdcard/dmesg.txt
    adb shell pull /sdcard/dmesg.txt

Send the logs

Attach the logs (you can find them inside the ADB & Fastboot tools folder) in the bug report message.