microg / microg/GmsCore

Correct way of installing microG as system-app

Open
#2,844 63 comments 3 reactions 0 assignees View on GitHub

Nobody has claimed this yet.

question
Dominant language
Java
Stars
14.6k
Forks
3.2k
Avg merge
12d 11h
Merged PRs (30d)
4

Description

Hello everyone,

I know that there are modules for Magisk that do the installation for you and I also know about LineageOS for microG. I tried those an they work great. I only got into problems when trying to update to a newer microG version. But I think I screwed this up.

But my question is not about the above its about how to correctly install microG on Android 15 from scratch. I installed it out of F-Droid but because it installs microG as an user app the phone won’t wake up when a push message comes in. At least that’s what I read. The installation instructions describe the process with the footnote to use adb push but without any further explanation.

Is this the correct procedure?

  • Naked phone without any microG installation but Magisk installed (LineageOS 22.1)
  • Enable adb debugging in developer settings
  • Enable adb root in developer settings
  • Connect phone
  • adb root
  • adb remount (makes /system/ write-able)
  • adb push com.google.android.gms-244735012.apk /system/app/
  • adb shell chmod 644 /system/app/com.google.android.gms-244735012.apk
  • adb push com.google.android.gsf-8.apk /system/app/
  • adb shell chmod 644 /system/app/com.google.android.gsf-8.apk
  • adb push com.android.vending-84022612.apk /system/app/ (optional)
  • adb shell chmod 644 /system/app com.android.vending-84022612.apk (optional)
  • adb reboot

I would like to understand the correct way and would appreciate any help.
Thanks in advance.

Contributor guide

No contributing guide indexed for this repository

First steps

  1. Read the whole issue, then the project's contributing guide.
  2. Comment on the issue to say you are picking it up — it saves two people doing the same work.
  3. Fork the repository and make your change on a branch.
  4. Open a pull request that references the issue number.

Research direction

Start with the installation instructions referenced in the issue and review the listed adb commands in the context of Android 15 and LineageOS 22.1. Done would be a clear, verified procedure for installing microG as a system app, including the relevant command details and any required corrections.

Written by the indexing model from the issue text.

Assessment

Tech stack
android
Domain
documentation, mobile
Issue type
Documentation
Difficulty
4/5
Estimated time
3-5 days
Activity status
Active
Clarity
Needs clarification
Newbie friendliness
30/100

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.