How To Install Generic System Image On Project Treble Devices [Phh-Treble]

With the release of Android 13, Google introduced many new features for the smartphones. One of the major aspects of the new operating system was Project treble. Project treble enables faster delivery of updates to the device, independent of the manufacturer. It basically separates the Android OS framework from the vendor implementations.

To even simplify things further, here is exactly what happens. Usually, when a software or system update is created by the developers, they pass it on to the device manufacturer who has to integrate it with its own OEM specific skin. Then they pass it to the tele-carriers and finally, the update reaches the users. However, with project treble, it by-passes the dependency on device maker. So, software or system updates reach the user quite faster than usual.

Now, you may ask what advantage a device gets if it supports Project Treble..? Well, it enables the device to install Generic System Image (GSI) based on AOSP. GSI refers to system partition files(the ones with .img extension). If we simplify the terms, “Generic” means that any image file can be installed on a device with support for Project Treble. These system image file can be from any vendor. This actually makes way for the various top ranking custom ROMs which users can easily flash on their devices. In this post, we will tell you how to install Generic System Image on Project Treble devices.

How To Install Generic System Image On Project Treble Devices

How To install Generic System Image on Project Treble Devices

Any device that runs Android 8.0 or 8.1 Oreo out-of-the-box, supports Project Treble. Primarily, there are two ways to install Generic System Image on any Project Treble supported device. You can either use TWRP or Fastboot method to flash the system.img file. We will take a look at both the methods. There may be some other device-specific procedure you have to follow.

First of all, you have to download GSI image file for your device. Here we have provided you with the image file of Lineage OS 15.1.

Download GSI ROM here

Various Methods to Install Generic System Image on Project Treble Devices

Before moving ahead into the installation procedures, you have to follow some guidelines. Also, you will need to install some tools to perform the GSI installation.

  • You will need to factory reset your device during the installation process. This will erase all the data stored on the device. So, we advise you to take a complete backup of your device data.
  • First, make sure whether your device supports Project treble or not. This guide will only be effective on devices with Project Treble. You can check if your phone supports Project treble or not. Check out our list of Project Treble supported devices.
  • It is mandatory that your device must have an unlocked bootloader to flash the GSI file.
  • If you wish to use flash GSI using TWRP, then you should install device-specific latest TWRP recovery.
  • Alternatively, if you want to follow the fastboot method 2, you’ve to install Android SDK tools on your PC.
  • You must Make sure that your phone is using the stock boot image/ramdisk image. You can look for your device-specific image here.
  • Some devices may fail due to dm-verity check. To fix, you can install latest Magisk to disable dm-verity.
  • A PC/Laptop with USB cable

Flash the GSI USing TWRP Method

Step-1 Download Generic System Image from the download section

Step-2 Move it to the phone’s internal storage or SD card.

Step-3 Switch off the device completely > Press and hold Power + Vol Down button to enter the recovery mode.

Step-4 Alternatively give the following command in the command prompt

adb reboot recovery

Step-5 In the TWRP menu, go to ‘Wipe’ > swipe the ‘Swipe to Factory Reset’ button.

Step-6 Go back to the TWRP Menu screen.

Step-7 Tap on the ‘Install’ button.

Step-8 Select the ‘Install Image’ button at the bottom > Navigate to the storage and select the IMG file.

Step-9 Then select ‘System Image’ > swipe to install Generic System Image >

Step-10 It will take a while to install. After it is complete, tap on the ‘Reboot System’ in TWRP Menu.

Flash the GSI USing ADB Fastboot Method

Now, this method requires the setting up of ADB and fastboot tool on your computer. It is comparatively simpler than the TWRP method. You have to use the command prompt

  • First of all, you have to factory reset your Android device.
  • After that download the Generic System Image of your choice.
  • Copy it to the folder where you have installed the ADB and fastboot. Usually, it’s in the C Drive, C:\adb.
  • While in the folder, hold the SHIFT key on the keyboard and right-click on an empty space inside the folder. adb command window
  • Select the option ‘Open PowerShell window here’.
  • Enable USB debugging on your device and connect it to the PC.
  • Reboot your device into the Fastboot mode using the given ADB command
    adb reboot bootloader
  • Now, give the following command to install Generic System Image on your Project Treble enabled devices
    fastboot flash system "system_img_name".img
  •  In the above step, replace the system_image_name with the actual file name of the GSI file you downloaded.
  • It will take a while to install. After that, you have to reboot your device. give the following command.
    fastboot reboot

So, that’s it, guys. This was a detailed guide on How to install Generic System Image on Project Treble enabled devices. If you have any queries regarding this, do let us know in the comments section.


  1. C:\Users\rodrigo\Downloads\twrp> fastboot flash system_img_name.img
    unknown partition ‘system_img_name.img’
    error: cannot determine image filename for ‘system_img_name.img’

    1. Read it carefully! “fastboot flash system “system_img_name”.img”! Not “fastboot flash system_img_name.img”! You are missing the partition name.

    1. You have to change the name to the name of the file you want to pass to the device

      g.e: “system_img_name” to
      The just example .

  2. So… this article assumes that everyone is using Windows? Ironic when most developers use Mac or Linux, just saying…

    1. It is very similar to Linux. For most commands you can just put a “./” in front of the command to execute it in the same directory.

    1. You don’t need to root your phone to install a custom ROM. You just need to unlock the bootloader to actually flash the system image.

  3. Can I do this when I’m in custom pixel experience ROM on Redmi note 7 Indian variant, I have flashed the GSI img but I got stucked in a boot loop please

  4. Você devia deletar este post, esse aparelho não é suportado pelo project treble. E não há nada nesses links que você colocou que seja direcionados ao k5 note 2018.

  5. How to install Gapps using ADB Fast boot?
    Given that as far as I know One Macro is not available?

  6. when i write : adb reboot bootloader ok the phone restart in fastboot mode but then when i write : fastboot flash system “system_img_name”.img (or any fastboot commands) i always get the same answer “waiting for device”.
    E10 and MTK Vcom usb drivers are well installed.
    Any idea ?

  7. if u try this on Oukitel Y4800 use the command “fastboot flashing unlock” then ur bootloader will be unlockes.

  8. i install the successfully ROM but when finally boot ,it take very long time in booting up, I was waited long time ,the divide pass boot loader logo (infinix ) I heard sound when plugged in USB ,
    used twice methods (twrp and adb) the problem is same ,
    how can solve it?

  9. I cant find any description how can i install TWRP to my device (if i wanna flash the GSI Image file with TWRP)

Leave a Reply

Your email address will not be published. Required fields are marked *

This site uses Akismet to reduce spam. Learn how your comment data is processed.