keyboard_arrow_left Back to the overview

Install LineageOS on
LG G2 Mini

g2m

Warning: The provided instructions are for LineageOS 14.1. These will only work if you follow every section and step precisely.
Do not continue after something fails!

Basic requirements

Read through the instructions at least once before actually following them, so as to avoid any problems due to any missed steps!
Make sure your computer has adb. Setup instructions can be found here.
Enable USB debugging on your device.
Boot your device with the stock OS at least once and check every functionality.
Warning: Make sure that you can send and receive SMS and place and receive calls (also via WiFi and LTE, if available), otherwise it won’t work on LineageOS either! Additionally, some devices require that VoLTE/VoWiFi be utilized once on stock to provision IMS.
LineageOS is provided as-is with no warranty. While we attempt to verify everything works you are installing this at your own risk!

Rooting your device

Important: The device must be rooted before proceeding any further.

Root your device by following this guide.

Installing a custom recovery using `dd`

Download a custom recovery - you can download one here.
Place the recovery image file on the root of /sdcard:
- Using adb: adb -d push <recovery_filename>.img /sdcard/<recovery_filename>.img
Tip: The file may not be named identically to what stands in this command, so adjust accordingly.
- You can use any method you are comfortable with. adb is universal across all devices, and works both in Android and recovery mode, providing USB debugging is enabled.
Now, open an adb -d shell from a command prompt (on Windows) or terminal (on Linux or macOS) window. In that shell, type the following commands:
```
su
dd if=/sdcard/<recovery_filename>.img of=/dev/block/platform/msm_sdcc.1/by-name/recovery
```
Reboot into recovery.
- From the same shell, type the following command:
```
reboot recovery
```

Installing LineageOS from recovery

Build a LineageOS installation package.
- (Optionally): If you want to install Google Apps add-on package (use the arm architecture), you can download it from here.
If you are not in recovery, reboot into recovery:
- With the device powered off, hold Volume Down + Power. When the LG logo appears, release both buttons and then hold them again. Choose ‘Yes’ twice to confirm.
  
  Note: Accept the factory reset prompt using the hardware buttons. If you have done everything correctly, this will not actually reset your device but instead will boot the custom recovery.
Now tap Wipe.
Now tap Format Data and continue with the formatting process. This will remove encryption and delete all files stored in the internal storage.
Return to the previous menu and tap Advanced Wipe, then select the Cache and System partitions and then Swipe to Wipe.
Sideload the LineageOS .zip package:
- On the device, select “Advanced”, “ADB Sideload”, then swipe to begin sideload.
- On the host machine, sideload the package using: adb -d sideload filename.zip.
  Tip: Normally, adb will report Total xfer: 1.00x, but in some cases, even if the process succeeds the output will stop at 47% and report adb: failed to read command: Success. In some cases it will report adb: failed to read command: No error or adb: failed to read command: Undefined error: 0 which is also fine.

Installing Add-Ons

Note: If you don’t want to install any add-on (such as Google Apps), you can skip this whole section!

Warning: If you want the Google Apps add-on on your device, you must follow this step before booting into LineageOS for the first time!

Repeat the sideload steps above for all desired packages in sequence.

All set!

Once you have installed everything successfully, you can now reboot your device into the OS for the first time!

Run adb -d reboot.

Note: The first boot usually takes no longer than 15 minutes, depending on the device. If it takes longer, you may have missed a step, otherwise feel free to get assistance.

Warning: Depending on which recovery you use, you may be prompted to install additional apps and services. We strongly advise you to opt out of installing these, as they may cause your device to bootloop, as well as attempt to access or corrupt your data.

Get assistance

After you’ve double checked that you followed the steps precisely, didn’t skip any and still have questions or got stuck, feel free to ask on our subreddit or in #LineageOS on Libera.Chat.

Install LineageOS on LG G2 Mini