Ubuntu Touch Installation Guide for Xiaomi POCO X3 NFC / X3

[Eric H]

Product Authentication

Verify your Xiaomi phone at official site.

Unlocking the bootloader

On Windows

The steps below only need to be run once per device. They require a machine running Windows 7 or newer.

Unlocking the bootloader will erase all data on your device!
Before proceeding, ensure the data you would like to retain is backed up to your PC and/or your Google account, or equivalent. Please note that OEM backup solutions like Samsung and Motorola backup may not be accessible from Ubuntu Touch once installed.

See : Complete Guide to Unlocking the Bootloader: Announcement, Troubleshoot and Tips

• https://new.c.mi.com/global/post/101245

Other resources :

• https://en.miui.com/unlock/download_en.html
• https://wiki.lineageos.org/devices/surya/install/#unlocking-the-bootloader

All platforms

MiUnlockTool developed to retrieve encryptData(token) for Xiaomi devices for unlocking bootloader.
It is compatible with all platforms.
https://github.com/offici5l/MiUnlockTool ( not tested)

Checking the correct firmware

Ubuntu Touch for surya / karna is based on Halium 10 and Android 10 Ubuntu Touch rootfs so it requires an Android 10 base firmware before it can be flashed on your phone. While custom ROMs like LineageOS 17.1 might work, they are untested and not recommended. Instead, use one of the MIUI Android 10 based firmware from below.

Pay attention to your device name before downloading the firmware below. Make sure you download the right firmware for your device, the firmware type is fastboot, and the Android version is 10.0!

Device model	Codename	Latest Android 10 firmware
POCO X3 NFC	surya	V12.0.9.0.QJGMIXM
POCO X3 (India)	karna	V12.0.10.0.QJGINXM (tested by @mahdi_saad_bd)

Flashing firmware

On Linux

0. Make sure fastboot is installed
1. Download your ROM - choose fastboot version
2. Unzip your ROM
3. Reboot your phone into fastboot mode (POWER + VOL_DOWN)
4. Connect your phone to your PC
5. Flash ROM using flash_all.sh script in your unzipped ROM.
   Depending on your Linux distribution and packages installed, you may or may not need sudo

   ./flash_all.sh
   

On Windows

Use Xiaomi Flash Tool — Official Mi Flash Tool.

• https://xiaomiflashtool.com/

️ Several users have reported that recent versions do not work. The 20181115 version has been successfully tested.

Installing Ubuntu Touch

Downloading / Installing Installer

You can install Ubuntu Touch using the UBports Installer on your computer.
Make sure your device is unlocked and has the required version of Android installed.

Linux

• Snap x64
• Debian x64
• Appimage x64

Windows & Mac

• exe x64
• dmg x64

Installation procedure

0. Don't plug your phone
1. Launch the installer on your desktop / laptop
2. Reboot your phone into fastboot mode (POWER + VOL_DOWN)
3. Plug your phone with USB
4. Follow the instruction on screen
   (at first installation Bootstrap and Wipe Userdata checkboxes must be checked)

Troubleshooting

• Install Ubuntu Touch - Troubleshooting
  • https://docs.ubports.com/en/latest/userguide/install.html#troubleshooting
• Some users report that they have not been able to install Ubuntu Touch from Windows (10 & 11), but that they have been able to do so with Linux
  • https://t.me/ubports/477974
• On Windows, installer stop at Rebooting to fastbootd
  • https://forums.ubports.com/post/76345
• If adb devices command does not list your device in recovery mode, try to check the Wipe Userdata checkbox during first installation
  • https://t.me/ubports/479483
  • https://t.me/ubports/479709
• Partition not found error
  • https://forums.ubports.com/post/87147
  • https://forums.ubports.com/post/87667