LineageOS for microG

The full Android experience without Google Apps

• Download
• Donate
• Installation
• Docs

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 LineageOS-based custom ROMs (e.g. IodéOS);
• for other devices, whether or not officially supported by those projects.

Project Status

The project is currently in a fairly stable state:

• we are (mostly) achieving our objective of delivering monthly builds
• the only essential work that is ongoing is to
  • monitor the delivery process, to fix any problems that may occur, and to make any changes that are needed to ensure that the problems do not recur
  • to make any changes needed when upstreams make changes. In particular, when LineageOS introduces support for a new Android version and / or drops support for older Android versions

The project is therefore - in the opinion of the currently active maintainers - essentially ‘feature complete’ and in ‘maintenance’ mode. The only change that we believe might significantly improve the project is to support other classes of Android devices, specifically

• Minimal & Android TV devices (Now mostly supported)
• Treble-capable devices which are not officially supported by LOS. As has recently been suggested building for the lineage_gsi target would make our builds available for and usable on these devices.

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): also made available on the download server
3. The Docker image used to make the builds: made available on DockerHub
4. Documentation
   • The main project wiki
   • The Docker image README.md and wiki

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

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’ 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 20-25 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

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:

• LineageOS (website, github repos)
• MicroG (website, github repos)

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.