Skip to content

Installation

ale5000 edited this page May 6, 2025 · 32 revisions

Please review the Prerequisites and Helpful Information before starting installation. All files can be found in the download section or in the microG F-Droid repository.

  1. Install the apk of microG Services.
    • See notes at the bottom.
    • If you built GmsCore using gradle, you can use adb install -r <filename.apk> on your computer.
  2. Install the apk of microG Companion.
    • If you have the official Play Store installed, skip this step.
  3. Optionally install the apk of microG Services Framework Proxy.
    • It is mainly needed just to use the legacy "Device to Cloud Messaging" (C2DM) push messaging system; in most cases you probably won't need it.
    • The microG Services Framework Proxy version does not need to match the microG Services version.
    • If you have Android >= 15 the normal installation of this component will probably fail, but you can download it on your computer and then install it using:
      • adb install -r --bypass-low-target-sdk-block <filename.apk>
  4. Open the microG Settings, which are available in the launcher now. If you want to use any Google services (Log-In, Cloud Messaging), tick both checkboxes for background services. This is the only supported setup, but you are free to disable them if you like playing with fire. You can also open the UnifiedNlp settings to enable the location backends of your choice.
  5. Reboot your device. If you skip this step, everything unwanted is possible.
  6. Disable Battery Optimization, if you use Android 6 (Marshmallow) or above. Ensure that it is disabled for microG Services Core in System Settings > Battery > Menu > Battery optimization. Note that this is the case for the original Play Services, as it is required to keep a stable background connection.

NOTE 1: On Android 7 (or later) an additional patch is needed to make location work, or alternatively:

  • You can install GmsCore.apk as a privileged system app (by putting it inside /system/priv-app/GmsCore/ using adb push).

NOTE 2: You can safely uninstall microG DroidGuard Helper and all UnifiedNlp backends if you installed them before, since now everything is integrated inside microG Services.

Clone this wiki locally