Clone this wiki locally
Recording a debug log
K-9 Mail has controllable debug logging. Users can activate logging to help diagnosing problems and errors.
Step 1: Activate Debug Logging in K-9 Mail
At the accounts screen of K-9 Mail press the menu button, then choose "Settings". Under the heading "Debugging" check the "Enable debug logging" checkbox. Hit the back button twice to save the changes.
If K-9 is crashing or you otherwise can't get to the settings screen, don't worry about about enabling debug logs.
Step 2: Trigger error
Do whatever causes the problem/error.
Step 3: Get Debug Log
To fetch the debug log you have to attach the device to your PC and use the tool
adb from the Android SDK:
- Follow these instructions to install adb and to connect your device.
To capture the debug log in a file named
k9-log.txt, enter the command:
adb logcat -d -v time k9:V '*:S' AndroidRuntime:E > k9-log.txt
Step 4: Create an Issue in our Bug Tracker
It's ok to remove your password from the debug log. Other than that, please give us as much of the log as you possibly can.
Important: Include the exact version number of your installed K-9 Mail in the bug report. Read GetVersionNumber if you need help on finding out which version of K-9 you're running.