Installation

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.

Verifying your downloads

All APK files are signed with our PGP key so you can verify them.

• They key has the signature 22F796D6E62E6625A0BCEFEA7F979A66F3E08422
• You can download it from keys.openpgp.org or the Ubuntu PGP Keyserver

The following procedure assumes a Linux environment with gnupg installed.

1. Download all .apk files with their .apk.asc counterparts
2. Import our key using the following command

# OpenPGP Keyserver
gpg --keyserver "keys.openpgp.org" --recv-keys "22F796D6E62E6625A0BCEFEA7F979A66F3E08422"
# Ubuntu PGP Keyserver
gpg --keyserver "keyserver.ubuntu.com" --recv-keys "22F796D6E62E6625A0BCEFEA7F979A66F3E08422"

3. Sign the key with your private key

gpg --sign-key "22F796D6E62E6625A0BCEFEA7F979A66F3E08422"

4. Verify the apk files

for app in *.apk.asc; do
  gpg --verify "$app"
done

All files should show "Good signature". Warning about untrusted keys are currently expected.

Installation

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.