This page contains information to help you help us by reporting an actionable bug for Ubuntu Touch. It does NOT contain information on reporting bugs in apps, most of the time their entry in the OpenStore will specify where and how to do that.

This might seem obvious, but it’s easy to miss. Go to (Settings - Updates) and make sure that your device doesn’t have any Ubuntu updates available. If not, continue through this guide. If so, update your device and try to reproduce the bug. If it still occurs, continue through this guide. If not, do a little dance! The bug has already been fixed and you can continue using Ubuntu Touch.

First, you’ll need to make sure that the bug you’re trying to report hasn’t been reported before. Search through the bugs reported. When searching, use a few words that describe what you’re seeing. For example, “Lock screen transparent” or “Lock screen shows activities”.

If you find that a bug report already exists, select the “Add your Reaction” button (it looks like a smiley face) and select the +1 (thumbs up) reaction. This shows that you are also experiencing the bug.

If the report is missing any of the information specified later in this document, please add it yourself to help the developers fix the bug.

Next, find out exactly how to recreate the bug that you’ve found. Document the exact steps that you took to find the problem in detail. Then, reboot your phone and perform those steps again. If the problem still occurs, continue on to the next step. If not…

We appreciate as many good logs as we can get when you report a bug. In general, /var/log/dmesg and the output of /android/system/bin/logcat are helpful when resolving an issue. I’ll show you how to get these logs.

Now it’s time for what you’ve been waiting for, the bug report itself! Bug reports need to be filed in English.

First, pull up the bug tracker and click “New Issue”. Log in to GitHub if you haven’t yet.

Next, you’ll need to name your bug. Pick a name that says what’s happening, but don’t be too wordy. Four to eight words should be enough.

Now, write your bug report. A good bug report includes the following:

What happened: A synopsis of the erroneous behavior

What I expected to happen: A synopsis of what should have happened, if there wasn’t an error

Steps to reproduce: You wrote these down earlier, right?

Logs: Attach your logs by clicking and dragging them into your GitHub issue.

Software Version: Go to (Settings - About) and list what appears on the “OS” line of this screen. Also include the release channel that you used when you installed Ubuntu on this phone.

Once you’re finished with that, post the bug. You can’t add labels yourself, so please don’t forget to state the device you’re experiencing the issue on in the description so a moderator can easily add the correct tags later.

A developer or QA-team member will confirm and triage your bug, then work can begin on it. If you are missing any information, you will be asked for it, so make sure to check in often!