Troubleshooting and Support - lineageos4microg/l4m-wiki GitHub Wiki

User Support

The LineageOS for MicroG project and the currently active maintainers do not have the time or resources to provide 'official' support for users of our ROMs. Fortunately, support and 'self-help' is available from the user community, in particular in the LineageOS for microG' XDA Forums thread.

  • the number of active volunteer maintainers / contributors is very small, and we spend what time we have trying to ensure that the process of making regular builds keeps going. We can generally investigate problems with the build tools, but not with the ROM itself;
  • we don't have access to any devices for testing / debugging

The issue tracker for the docker-lineage-cicdrepository is mostly for tracking problems with the Docker build tool. It is not intended for tracking problems with installing or running the LineageOS for MicroG ROM. If you run into such problems, our advice is to work through the following steps to see if they help. (Make a backup of your user apps & data first):

  • full power off and restart
  • factory reset
  • format data partition
  • install the most recent LineageOS for MicroG build for your device, from here following the LOS installation instructions.
  • install the latest official LineageOS build from here

For any problems, with building, installing, or running LineageOS for MicroG, we recommend that you ask for help in the XDA Forum thread or in device specific XDA forum threads. The LineageOS for MicroG forum thread is not maintained by us, but there are many knowledgeable contributors there, who build and run the LineageOS for MicroG ROM on a wide variety of devices.

Issue Reporting & Tracking

Our public github repos have issue trackers, where any github user can create new issues. They are primarily intended for

  • reporting and tracking problems with the components owned by the repos, i.e. the Docker image, and our integration of the microG components.
  • reporting and tracking problems with the website and wiki documentation
  • asking questions about how to use the components
  • suggesting improvements to those components e.g.
    • ways in which the docker image could be changed to make the build process more efficient, or less error-prone
    • how our limited documentation (primarily the README.md) could be improved

They are not intended for

  • problems 'owned' by the upstream projects e.g incorrect functionality, or requests for new or different functionality in
    • apps which are 'built-in' to LineageOS
    • microG components (unless the incorrect functionality is caused by our integration of those components)
  • problems which are out of scope, i.e. problems in our upstream projects (LineageOS. microG, F-Droid), or device-specific issues. Upstream projects have their own channels for supporting users.
  • providing support for users of our ROMs (see below)
  • requests for new features in our components. We believe the project is 'feature complete', and the project does not have the time and / or resources to expand its scope, even if we thought such expansion was desirable. We will consider any such feature requests (when / if we have the time to do so), but the answer is likely to be negative.

One area where we know improvements can be made is in showing the progress (or lack of progress) in addressing reported issues:

  • currently an issue is either 'Open' or 'Closed'
  • no indication of whether 'Open' issues will be fixed or not
  • no visibility of the priority of open issues, or when or in what order they will be addressed
  • no indication of whether 'Closed' issues were fixed or not before closure

Some gradual changes are in hand to address this.

Where do I report a bug

Where fo I eport a bug