Skip to content
Pete Fotheringham edited this page Jan 13, 2025 · 16 revisions

LineageOS for microG

The full Android experience without Google Apps

The full Android experience without Google Apps

Welcome to the LineageOS for microG wiki!

The project website is at https://lineage.microg.org/

About

LineageOS for microG is a custom Android ROM which integrates the following components:

  • The LineageOS Android Distribution
    A free and open-source operating system for various devices, based on the Android mobile platform.
  • microG
    A free-as-in-freedom re-implementation of Google’s proprietary Android user space apps and libraries, enabling the use of every Google service you need without keeping another closed-source binary blob in your Android system
  • The F-Droid App store
    An installable catalogue of FOSS (Free and Open Source Software) applications for the Android platform. You can use it to access plenty of FOSS applications or even the Play Store via Aurora Store.

Project Objectives

  1. Make regular builds of our ROM for all the phones and tablets currently supported officially by LineageOS;
  2. Make the builds available for download for manual and OTA installation
  3. Create and maintain the tools and computing resources needed to achieve 1 & 2.

A secondary objective is to make our main build tool available for other projects and individuals to use to make and maintain their own builds:

  • of LineageOS for microG, 'vanilla' LineageOS, and / or other LOS-based custom ROMs (e.g. IodéOS);
  • for other devices, whether or not officially supported by those projects.

Project deliverables

  1. The device-specific ROM zip files, for manual and OTA installation: made available in sub-directories on the download server
  2. Other device-specific zip and .img files that are needed for installing or updating the ROM zip file (e.g. boot.img, recovery.img).
  3. The Docker image used to make the builds: made available on DockerHub
  4. Documentation

Build Targets and Frequency

We build for the same devices as LineageOS using their list of build targets as the input to our build run.

We aim to make builds monthly, and we (usually) start a 'build run' starting on the first day of the month. The devices included in a build run are defined by the content of the LineageOS target list at the point the build run starts. Our monthly build run takes 15-20 days to complete. The progress of the build run is published in a dedicated matrix room

If builds for any devices fail during a build run, we will try the build again after the main build run has completed. If you do not see a new build for your device when you expect it, please check whether the build failure was reported in the matrix room. If it was, there is no need to report it - we will deal with it! If the failure was not reported in the matrix room, then please report it in the docker-lineage-cicd project issue tracker or in the XDA Forums thread

Builds for devices no longer supported by LineageOS

When LineageOS stop supporting a device, the last LineageOS for MicroG build will be kept available on our download server

Some builds for devices which were last supported at version lineage-18.1 can be found on the Wayback Machine / Internet Archive

Project Github repositories

The project has two main public repositories on GitHub:

  • docker-lineage-cicd The Docker image used by the project to make the regular builds, along with a README.md explaining how it can be used. The Docker images is rebuilt and pushed to DockerHub automatically when changes are pushed to the master branch
  • android_vendor_partner_gms The pre-built components from MicroG, along with makefiles for easy integration in the Android build system. The pre-built components are pulled automatically from the MicroG releases.

Upstreams

The project has two main 'upstream` projects:

Like LineageOS, the project also uses 'TheMuppets` github and gitlab repos as the source for device-specific vendor binary blobs.

The main work of the project is to integrate the upstream components and build them into the ROM images we make available.

Project Sponsor

Thanks to SysEleven who are generously providing the cloud computing resources the project uses to make and publish our builds, and to host this site.

© LineageOS for microG.