Skip to content

About

This Guide is intended for new users of Generic System Image (GSI) .

Topics

Resources

Stars

0 stars

Watchers

0 watching

Forks

Latest commit

 

History

20 Commits

Folders and files

NameName
Last commit message
Last commit date
 
 

Repository files navigation

GSI Guide: Installing GSI & Checking Treble Support

For: Android Enthusiasts Who Want to Install a GSI
This guide assumes your device bootloader is already unlocked, you have a PC, USB cable, and basic knowledge of ADB & Fastboot.


1. Check Treble & GSI Support

1.a Using Treble Info App

  • Download Treble Info app from Play Store.
  • Open it and confirm:
    • Is your device Treble compatible? → Should say Yes.
    • Partition type: → Should be A/B or A-only.

1.b Manual Method

Connect your device and run:

adb shell getprop ro.treble.enabled

  • If it returns true → Device supports Treble & GSIs.
  • If false → GSI installation is NOT supported.

2. Download a Suitable GSI

  • Download a GSI image of your choice (e.g., Phh-Treble, LineageOS GSI).
  • Match the GSI architecture (arm, arm64, aonly, ab) with your device’s partition type.

2.a Gsi Naming

{arm|a64|arm64}_{a|b}{v|g}{N|S}-{vndklite|secure|personal}
|               |    |    |     |
|               |    |    |     vndklite: For VNDKLite devices,
|               |    |    |               or for read-writeable /system on regular devices
|               |    |    |     secure: Superuser removed and system props spoofed,
|               |    |    |             for better chances of passing SafetyNet
|               |    |    |     personal: With personal mods, for reference
|               |    |    |
|               |    |    N: No Superuser
|               |    |    S: *Built* with PHH Superuser (app needed)
|               |    |    (Z): *Built* with eremitein's Dynamic Superuser (not offered here)
|               |    |
|               |    v: Vanilla, i.e. no GAPPS
|               |    g: With regular GAPPS
|               |    o: With Android Go GAPPS
|               |    (f): With built-in MicroG and FLOSS replacements of GAPPS (not offered here)
|               |
|               a: "A-only", i.e. system-as-system (deprecated since Android 12)
|               b: "AB", i.e. system-as-root
|
arm: ARM 32-bit (deprecated since Android 12)
a64: ARM 32-bit with 64-bit binder
arm64: ARM 64-bit

3. Prepare & Flash the GSI

3.a Boot to Fastboot Mode

adb reboot bootloader

3.b Wipe for Clean Install (Recommended)

fastboot erase system

fastboot erase userdata

3.c Flash the GSI Image

  • If your GSI is zipped, unzip it first to get the .img file.

  • Flash the system image:

    fastboot flash system .img

  • For A/B devices, flash vbmeta with verity and verification disabled (if required):

fastboot --disable-verity --disable-verification flash vbmeta vbmeta.img

3.d Reboot Device

fastboot reboot

--

4. First Boot & Troubleshooting

  • The first boot after flashing a GSI can take several minutes — be patient!
  • If you encounter bootloops:
    • Verify you are flashing the correct GSI for your device’s architecture and slot configuration.
    • Consider reflashing your stock ROM and trying again.

Resources & Credit

If you want to test gsi before directly flashing and without risking userdata you may see this

Guide https://github.com/Swastik369/How_to_use_DSU_sideloader

About

This Guide is intended for new users of Generic System Image (GSI) .

Topics

Resources

Stars

0 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors