How to submit a bug report
What not to report
- Bugs in unofficial builds or anything not downloaded from our official portal
- Missing builds
- Asking for installation help
- Asking for device support
- Feature requests
Reporting a bug
We use Gitlab Issues as our bug tracker. Before you submit a bug, please search to verify that someone else hasn’t reported it already.
Please do not:
- Post “Me too” or “+1” messages on existing reports
- Comment your device as affected on a report for a different device - different devices have different maintainers, and different reasons for bugs to exist
- Ask if it is fixed already - if the report is still open it probably is still present!
- Ask for status updates - we can’t provide them (no ETA!)
- Ping people/maintainers - most of them already check the tracker
We accept bugs on the following:
Android bugs
These are bugs in LineageOS itself, e.g.
- The fingerprint sensor on your device doesn’t work.
- Your phone crashes when you try to enable encryption.
- WiFi calling doesn’t work.
When adding a bug report, please do not use the email functionality, since we provide a template that needs to be filled out properly.
Please read the template carefully and pay special attention to the last section, containing lines starting with /.
These lines are parsed by a bot which will mark your issue as invalid if you do not fill them out properly.
Keep the lines exactly as they are and add your information next to it, e.g. /device codename or /version lineage-19.1 but not /device My Device (codename) - which the bot will not be able to parse.
Most of the requested information can be found on your device if you go to Settings->About phone and click on the Android version item.
Make sure to fill out the template with accurate information, and in the format requested. It doesn’t matter if your baseband version has nothing to do with a lock screen animation issue, if it is not there your bug will be closed.
Infrastructure bugs
These are bugs in our website and/or software, e.g.
- The download portal doesn’t render something correctly.
- There’s a dead link on the website.
- An API returns something unexpected.