04

Troubleshooting

Capture the logs that let us reproduce a problem, and where to file it.

Something will eventually misbehave. We can rarely act on a report without logs, so this page covers how to capture them.

Reporting an issue

Update to the latest build for your device first, then open a ticket on our GitHub issue tracker. Attach both a logcat and a dmesg.

Capturing a logcat

  1. Open Settings, then About phone, and tap Build number seven times.
  2. Open Settings, then System, then Developer options, and turn on USB debugging.
  3. Run the capture from a terminal on your computer.
shell
adb logcat -d > logcat.log
System log
shell
adb logcat -db radio > radio.log
Radio buffer, if we ask for it

Capturing a dmesg

A kernel log needs root. Userdebug builds of CipherOS give you a root shell out of the box.

  1. Turn on USB debugging as above, and also turn on Rooted debugging in Developer options.
  2. Run the capture from a terminal on your computer.
shell
adb root
adb shell dmesg > dmesg.log
Kernel log

Still stuck? Ask on Telegram with your logs attached.