Installation

realmain edited this page Dec 28, 2017 · 12 revisions

Please review the Prerequisites and Helpful Information before starting installation.

  1. Install GmsCore.apk (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 GsfProxy.apk as provided in the download section if you want to use Google Cloud Messaging ("Push-Notifications"). The GsfProxy version does not need to match the GmsCore.apk version and is installable without higher privileges.
  3. Install a PlayStore APK
    • If you have BlankStore installed, continue with the next step.
    • If you want to be able to access the Play Store, install BlankStore from the XDA thread. It is not a requirement that you set it up correctly and this is not covered by this instructions. If you need help ask in the BlankStore original thread.
    • If you don't care about Play Store access, Install FakeStore.apk as provided in the download section.
  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. If you don't have any yet, check out F-Droid. For further questions and concerns regarding UnifiedNlp, use its corresponding GitHub repo or XDA thread.
  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: On Android 7 (or later) an additional patch is needed to make location work, or alternatively, you can install GmsCore.apk in the /system/priv-app folder. This can be done by using adb push.

You can’t perform that action at this time.
You signed in with another tab or window. Reload to refresh your session. You signed out in another tab or window. Reload to refresh your session.
Press h to open a hovercard with more details.