Installing Generic System Image (GSI) on Xiaomi smartphones is a way to get a clean Android without the MIUI shell, test new OS versions or restore the device to work after unsuccessful experiments. However, the process requires technical preparation, from unlocking the bootloader to choosing the right firmware image. Unlike standard custom firmware like LineageOS or Pixel Experience, GSI is versatile — it is suitable for most devices with Project Treble support, but has its own nuances on Xiaomi.
In this article, we will look at the whole process from A to Z: what models are supported, how to avoid bricks, what tools you will need and how to solve common errors like fastboot: error: can’t load or logo hovers. Particular attention will be paid to unlocking the bootloader, the most critical stage where many users face problems due to Xiaomi policies. If you are a beginner, we recommend you to carefully study each step and not miss warnings.
⚠️ Attention: Installation GSI It resets all the data on the device. Backup through adb backup or TWRP It will not help – you need a full backup on the PC (photos, contacts, SMS). Please note that certain functions (for example, IR-blaster or camera may not work properly due to lack of proprietary drivers.
1.What is GSI and why is it needed by Xiaomi
Generic System Image (GSI) is a universal image of the Android system created by Google as part of Project Treble. Its key difference from conventional custom firmware is compatibility with any device that supports the separation of the vendor and system (System), on Xiaomi this is true for models released after 2018 (with Android 8.1 Oreo and later).
The main reasons for installing GSI are:
- 🧹 Pure Android without a MIUI And its advertising, its over-services.
- 🔄 Testing new versions (e.g. Android 15 before official release).
- 🛠️ Recovery of the device after a failure of standard firmware.
- 📱 Unification of the interface on multiple devices (for example, for developers).
However, there are downsides: the lack of optimization for the hardware Xiaomi can lead to bugs with the camera, sensors or performance. for example, on the Redmi Note 10 Pro (sweet), GSI often does not support 4K@60fps on the main camera, and Poco F3 (alioth) may not work navigation gestures.
2. Compatibility Check: Does your Xiaomi GSI support?
Not all Xiaomi smartphones are GSI compatible, but the main condition is Project Treble support, which can be checked in two ways:
- Through Treble Check: Download it from Google Play. Run and check the Seamless System Updates string - it should be Supported.
Manual method (via ADB):
adb shell getprop ro.treble.enabledIf the answer is true, the device supports GSI.
It is also important to know the processor architecture (ARM64 or ARM32) and the type of markup (A/B or A-only).
adb shell getprop ro.product.cpu.abi
adb shell getprop ro.build.ab_update📌 List of popular Xiaomi models with support GSI:
| Model | Code name | Architecture | Type of marking |
|---|---|---|---|
| Poco F3 | alioth | ARM64 | A/B |
| Redmi Note 10 Pro | sweet | ARM64 | A/B |
| Mi 11 | venus | ARM64 | A/B |
| Poco X3 Pro | vayu | ARM64 | A-only |
| Redmi K40 | alioth | ARM64 | A/B |
⚠️ Note: Devices with MediaTek processors (e.g., Redmi Note 9 Pro on Helio) G90T) often have problems with GSI Because of the closed source drivers, check the forum reviews before you install them. XDA Developers or 4PDA for your model.
3. Preparation: Unlocking the loader and installing tools
The hardest part is unlocking the bootloader. Xiaomi officially allows this, but the process can take up to 720 hours (30 days) due to security policy.
- Link your Mi Account to your device: Go to Settings → Xiaomi Account → Mi Cloud and log in. Enable Settings → Additional → Developers → Unlock OEM.
Mi Unlock Tool
:
- Download the utility from the official website.
- Run it in Fastboot mode (hold Power + Vol− when you turn it on).
- Connect your phone to your PC and follow the instructions. If a Couldn't unlock error occurs, wait until the specified time (usually 168 or 720 hours).
🔧 Essential tools:
- 🔌 Cable USB Type-C (original, undamaged).
☑️ Preparation for installation GSI
⚠️ Note: If you are using Windows, disable driver signature verification, otherwise fastboot will not recognize the device:
- Open the Command Prompt (Administrator).
- Enter: bcdedit /set nointegritychecks on
- Restart the PC.
4. Step-by-step: Install GSI on Xiaomi
When the bootloader is unlocked and all the tools are ready, we start installing, and the process is different for A/B and A-only markup devices.
For devices with A/B markup (e.g. Poco F3, Mi 11)
- Go to Fastboot: Adb Reboot Bootloader Mode
- Sweep GSI to the inactive slot: fastboot flash system.img (where system.img is your firmware file).
- Clear the cache: fastboot -w fastboot reboot
For A-only markup devices (e.g. Poco X3 Pro)
- Remove the old system: fastboot erase system
- The new system is called fastboot flash system.img.
- Recreate the vendor section (if required): fastboot flash vendor vendor.img (file vendor.img can be extracted from the stock firmware MIUI).
🔹 Important: If the device is stuck on the logo after the reboot, try it:
- 🔄 Ask me again. GSI compressed (--disable-verity --disable-verification).
- 🛠️ Install the core (boot.img) stock-stack.
💡
If the sensor does not work after installing the GSI, download an alternative image with support for GSI Dynamic Partitions (see the dynamic label in the firmware description).
5. Typical errors and their solutions
Even with the exact following of the instructions, there can be problems.
| Mistake. | Reason. | Decision |
|---|---|---|
| fastboot: error: cannot load 'system.img' | A damaged file or a wrong path | Check the integrity of the archive (MD5) and use the full file path |
| Hanging on the Xiaomi logo | Incompatible core or no vendor | Please. boot.img from the stock firmware or use --disable-verity |
| Mistake. INVALID SLOT | Problem with A/B markup | Specify the slot manually: fastboot --set-active=_a |
| The mobile network is not working | There are no proprietary modem drivers. | Select a vendor and firmware from stock MIUI |
📌 Debugging tip: If the device doesn't boot, connect it to your PC and check logs through:
adb logcatLook for lines with E/ (errors) or F/ (fatal crashes). For example, E/SensorHal: unable to open sensor indicates a sensor problem.
What if the camera doesn’t work after GSI?
6.GSI optimization after installation
Once installed successfully, the system may not work well, and here's how to improve performance and functionality:
- ⚡ Disable unnecessary services: adb shell pm uninstall --user 0 com.miui.analytics (this will remove Xiaomi telemetry if it remains).
- 🔋 Set up the kernel: Install Kernel Adiutor or FrancoKernel to control CPU frequencies and save charge.
- 📡 Fix the net: If it doesn't catch 4G, Switch modem and firmware from the latest stock firmware.
- 🎮 Improve Gaming Performance: Enable Force GPU Rendering in the Developer Settings.
Critical! On some devices (e.g. Poco F3), Widevine L1 support is disabled after installing GSI, which blocks Netflix and Disney+ viewing in HD. To return it, run the original vendor and install the Magisk L1 Patch module.
💡
After installing the GSI, be sure to check the sensors (gyroscope, compass, NFC) through the Sensor Test app. If any features are missing, go back to the stock firmware or find an alternative GSI image that supports your device.
7 How to Recover MIUI After GSI
If GSI is unstable or you need all the features of MIUI, you can return the stock firmware via Fastboot or Recovery. The most reliable way is to use the official firmware package from Xiaomi’s website:
- Download the firmware for your model from the official portal (choose the version of Fastboot).
- Unpack the archive and launch the script: flash_all.bat (for Linux/Mac — flash_all.sh).
- Wait until the device is finished (the device will restart automatically).
⚠️ Note: If, after returning to the MIUI The device requires authorization to Mi Account, but you don't remember it, you'll have to wait 72 hours to unlock it through the Mi Unlock Tool!