Ubuntu Touch Installation Guide for Xiaomi POCO X3 NFC / X3

Eric H

0. Product Authentication

Verify your Xiaomi phone at official site

https://www.mi.com/global/verify

1. Unlock 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 :

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)

2. Check the correct version of MIUI

Ubuntu Touch for surya / karna is based on Halium 10 and Android 10 Ubuntu Touch rootfs so it requires an Android 10 based MIUI 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 Android 10 based MIUI from below.

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

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

3. Flash MIUI

Install a recent version of fastboot and adb

On Linux

Make sure a recent version of fastboot is installed
Download your ROM - choose fastboot version
Unzip your ROM
Reboot your phone into fastboot mode (POWER + VOL_DOWN)
Connect your phone to your PC
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.

4. Install Ubuntu Touch

Install a recent version of fastboot and adb

Download / Install UBports 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
Windows & Mac
- exe x64
- dmg x64

Installation procedure

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

Troubleshooting

If installation fails with Partition not found error, try to update fastboot and adb.
If the installer cannot complete the download of the required files, try to use a VPN.
If installer stalls at step Adb is scanning for devices, try to check the Wipe Userdata checkbox during first installation.
On Windows, if installer stop at Rebooting to fastbootd, try to install the universal adb driver and reboot your computer.
Several users report that they have not been able to install Ubuntu Touch from Windows, but that they have been able to do so with Linux.
See also "Install Ubuntu Touch - Troubleshooting"

If you do not find a solution, share your logs on Telegram (see section 5 of this document).
You will find these logs in this folder:

~/.cache/ubports on Linux
%appdata%\ubports on Windows

5. Get help

On Telegram

UBports Welcome & Install help: https://t.me/WelcomePlus
Ubuntu Touch for POCO X3 NFC (Bridged to Matrix): https://t.me/ut_pocox3

6. Return to android

If necessary, to return to android, flash MIUI (see section 3 of this document).