Installation

Please review the Prerequisites and Helpful Information before starting installation.

1. Install the apk of microG Services (see note at the bottom) as provided in the download section or in the microG F-Droid repository.
   • If you built GmsCore using gradle, you can use adb install <filename> on your computer.
2. Install the apk of microG Companion (or alternatively the official Play Store).
   • If you have Play Store installed, skip this step.
   • The apk of microG Companion can be found in the download section.
3. Optionally install the apk of microG Services Framework Proxy as provided in the download section.
   • It is needed to use the legacy "Device to Cloud Messaging" (C2DM) push messaging system.
   • The microG Services Framework Proxy version does not need to match the microG Services version.
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.