Install Ubuntu Touch#

Installing Ubuntu Touch is easy, and a lot of work has gone in to making the installation process less intimidating to the average user. The UBports Installer is a nice graphical tool that you can use to install Ubuntu Touch on a supported device from your Linux, Mac or Windows computer. For more experienced users, we also have manual installation instructions for every device on the devices page.

Uyarı

If you’re switching your device over from Android, you will not be able to keep any data that is currently on the device. Create an external backup if you want to keep it.

You can Download the UBports Installer from GitHub. The following packages are available:

Start the installer and follow the on-screen instructions that will walk you through the installation process. That’s it! Have fun exploring Ubuntu Touch!

If you’re an experienced android developer and want to help us bring Ubuntu Touch to more devices, visit the porting section.

Not

Please do not start the installer with sudo. It is meant to be run as a normal user, not as root. Using the installer with sudo will mess up permissions in the installer’s cached files and lead to problems down the road. If the installer does not recognize your device, check the troubleshooting information below.

Troubleshooting#

If you need help, you can join UBports’ support channels on telegram or matrix or ask a question in the forum or on askubuntu. If you believe that the UBports Installer is not working correctly, you can also file a new issue to help us solve the problem.

Connection lost during installation#

Try a different USB cable and a different USB port on your computer. Cheap and old cables tend to lose connection during the installation.

Windows Defender prevents Installer from starting#

We have contacted Microsoft about this problem, but they seem to think it’s enjoyable. To dismiss the warning, click on “More Information”, then select “Run anyway”.

Device not detected#

Virtual Machine#

If you’re running the installer in a virtual machine, make sure the virtual machine is allowed to access the USB port.

Windows ADB drivers#

Install the universal adb driver and reboot your computer.

Fairphone 2 Vendor-ID#

Run echo 0x2ae5 >> ~/.android/adb_usb.ini in the terminal and restart the installer. This does not affect the snap package.

Missing udev-rules#

If the device is not detected on Linux and you are not using the snap package, then you might be missing some udev-rules.

  1. See if /etc/udev/rules.d/51-android.rules exists and contains the rules below. If not, add them to the file and run sudo service udev restart or sudo udevadm control --reload-rules && udevadm trigger.

SUBSYSTEM=="usb", ATTRS{idVendor}=="0e79", MODE="0666", GROUP="plugdev"
SUBSYSTEM=="usb", ATTRS{idVendor}=="0502", MODE="0666", GROUP="plugdev"
SUBSYSTEM=="usb", ATTRS{idVendor}=="0b05", MODE="0666", GROUP="plugdev"
SUBSYSTEM=="usb", ATTRS{idVendor}=="413c", MODE="0666", GROUP="plugdev"
SUBSYSTEM=="usb", ATTRS{idVendor}=="0489", MODE="0666", GROUP="plugdev"
SUBSYSTEM=="usb", ATTRS{idVendor}=="091e", MODE="0666", GROUP="plugdev"
SUBSYSTEM=="usb", ATTRS{idVendor}=="18d1", MODE="0666", GROUP="plugdev"
SUBSYSTEM=="usb", ATTRS{idVendor}=="0bb4", MODE="0666", GROUP="plugdev"
SUBSYSTEM=="usb", ATTRS{idVendor}=="12d1", MODE="0666", GROUP="plugdev"
SUBSYSTEM=="usb", ATTRS{idVendor}=="24e3", MODE="0666", GROUP="plugdev"
SUBSYSTEM=="usb", ATTRS{idVendor}=="2116", MODE="0666", GROUP="plugdev"
SUBSYSTEM=="usb", ATTRS{idVendor}=="0482", MODE="0666", GROUP="plugdev"
SUBSYSTEM=="usb", ATTRS{idVendor}=="17ef", MODE="0666", GROUP="plugdev"
SUBSYSTEM=="usb", ATTRS{idVendor}=="1004", MODE="0666", GROUP="plugdev"
SUBSYSTEM=="usb", ATTRS{idVendor}=="22b8", MODE="0666", GROUP="plugdev"
SUBSYSTEM=="usb", ATTRS{idVendor}=="0409", MODE="0666", GROUP="plugdev"
SUBSYSTEM=="usb", ATTRS{idVendor}=="2080", MODE="0666", GROUP="plugdev"
SUBSYSTEM=="usb", ATTRS{idVendor}=="0955", MODE="0666", GROUP="plugdev"
SUBSYSTEM=="usb", ATTRS{idVendor}=="2257", MODE="0666", GROUP="plugdev"
SUBSYSTEM=="usb", ATTRS{idVendor}=="10a9", MODE="0666", GROUP="plugdev"
SUBSYSTEM=="usb", ATTRS{idVendor}=="1d4d", MODE="0666", GROUP="plugdev"
SUBSYSTEM=="usb", ATTRS{idVendor}=="0471", MODE="0666", GROUP="plugdev"
SUBSYSTEM=="usb", ATTRS{idVendor}=="04da", MODE="0666", GROUP="plugdev"
SUBSYSTEM=="usb", ATTRS{idVendor}=="05c6", MODE="0666", GROUP="plugdev"
SUBSYSTEM=="usb", ATTRS{idVendor}=="1f53", MODE="0666", GROUP="plugdev"
SUBSYSTEM=="usb", ATTRS{idVendor}=="04e8", MODE="0666", GROUP="plugdev"
SUBSYSTEM=="usb", ATTRS{idVendor}=="04dd", MODE="0666", GROUP="plugdev"
SUBSYSTEM=="usb", ATTRS{idVendor}=="0fce", MODE="0666", GROUP="plugdev"
SUBSYSTEM=="usb", ATTRS{idVendor}=="0930", MODE="0666", GROUP="plugdev"
SUBSYSTEM=="usb", ATTRS{idVendor}=="19d2", MODE="0666", GROUP="plugdev"
SUBSYSTEM=="usb", ATTRS{idVendor}=="2ae5", MODE="0666", GROUP="plugdev"
SUBSYSTEM=="usb", ATTRS{idVendor}=="2a45", MODE="0666", GROUP="plugdev"

Other issues#

If the troubleshooting tips do not work, you might also try following the manual installation instructions for your device on the devices page.

Install on legacy Android devices#

While the installation process is fairly simple on most devices, some legacy Bq and Meizu devices require special steps. This part of the guide does not apply to other devices.

Not

This is more or less uncharted territory. If your device’s manufacturer does not want you to install an alternative operating system, there’s not a lot we can do about it. The instructions below should only be followed by experienced users. While we appreciate that lots of people want to use our OS, flashing a device with OEM tools shouldn’t be done without a bit of know-how and plenty of research.

Meizu devices are pretty much stuck on Flyme. While the MX4 can be flashed successfully in some cases, the Pro5 is Exynos-based and has its own headaches.

Uyarı

BE VERY CAREFUL! You are responsible for your own actions!

  1. Disconnect all devices and non-essential peripherals from your PC. Charge your device on a wall-charger (not your PC) to at least 40 percent.

  2. Download the Ubuntu Touch ROM for your device and extract the zip files:

  3. Download the latest version of SP flash tool (aka MTK flash tool).

  4. Extract the zip files

  5. Open a Terminal, enter the SP flash tool directory and run it with sudo ./flash_tool.sh.

Not

On Ubuntu 17.10, there are issues with flash_tool loading the shared library ‘libpng12’, so this can be used as a workaround:

wget -q -O /tmp/libpng12.deb http://mirrors.kernel.org/ubuntu/pool/main/libp/libpng/libpng12-0_1.2.54-1ubuntu1_amd64.deb \
&& sudo dpkg -i /tmp/libpng12.deb \
&& rm /tmp/libpng12.deb
  1. In the “Scatter-loading File” section, press the “choose” button and select the *Android_scatter.txt file from the archive you downloaded in the second step.

  2. Choose “Firmware Upgrade” from the drop-down menu.

Uyarı

If you select DOWNLOAD ONLY rather than FIRMWARE UPGRADE, you will end up with a useless brick rather than a fancy Ubuntu Touch device. Be sure to select FIRMWARE UPGRADE.

Also, after selecting the *Android_scatter.txt, the drop-down menu choice is reset to DOWNLOAD ONLY. Be sure to select it after selecting the file.

  1. Turn your device completely off, but do not connect it yet.

  2. Press the button labeled “Download”.

  3. Perform a final sanity-check that you selected the “Firmware Upgrade” option, not “Download Only”.

  4. Make sure your device is off and connect it to your PC. Don’t use a USB 3.0 port, since that’s known to cause communication issues with your device.

  5. Magic happens. Wait till all the progress bars ended.

Not

If the installation fails with a 100% red bar and hangs there (and logs says something like COM port is open. Trying to sync with the target...), remove the modemmanager package as the one installed is not compatible with SP flash tool, close it and try again from step 4.

  1. Congratulations! Your device will now boot into a super old version of Ubuntu Touch. You can now use the UBports Installer to install an updated version.