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.
Warning
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.
DMG images can be attached and deattached from inside darling shell with hdiutil. This is how you can install Xcode along with its toolchain and SDKs (note that Xcode itself doesn't run yet): This is how you can install Xcode along with its toolchain and SDKs (note that Xcode itself doesn't run yet).
- Converting a Mac DMG image to ISO in Ubuntu. Mac DMG images are practically unusable in a non-Mac system in that format. They can be converted to ISO images in Ubuntu for easy burning, mounting, or use in a virtual machine. Once you have the DMG file you want to convert to an ISO file, you need to install dmg2img.
- Apr 20, 2010 DMG2IMG is an Apple's compressed dmg to standard (hfsplus) image disk file convert tool. It is derived from dmg2iso v0.2c by vu1tur. It will allow you to convert a DMG file into an IMG file that can be mounted as described in ManageDiscImages.
You can Download the UBports Installer from GitHub. The following packages are available:
Windows:
ubports-installer-<version-number>.exe
macOS:
ubports-installer-<version-number>.dmg
Ubuntu or Debian:
ubports-installer-<version-number>.deb
Other Linux distributions (snap):
ubports-installer-<version-number>.snap
Other Linux distributions (AppImage):
ubports-installer-<version-number>.AppImage
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.
Note
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 echo0x2ae5>>~/.android/adb_usb.ini
in the terminal and restart the installer. This does not affect the snap package.
Missing udev-rules¶
If the device not detected on Linux and packages other than snap, you might be missing udev-rules.
See if
/etc/udev/rules.d/51-android.rules
exists and contains the rules below. If not, add them to the file and runsudoserviceudevrestart
orsudoudevadmcontrol--reload-rules&&udevadmtrigger
.
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.
Note
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.
Warning
BE VERY CAREFUL! You are responsible for your own actions!
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.
Download the Ubuntu Touch ROM for your device and extract the zip files:
Bq E4.5 (krillin)
Bq E5 HD (vegetahd)
Bq M10 HD (cooler)
Bq M10 FHD (frieza)
Meizu MX4 (arale)
Download the latest version of SP flash tool (aka MTK flash tool).
Extract the zip files
Open a Terminal, enter the SP flash tool directory and run it with
sudo./flash_tool.sh
.
Note
Ubuntu Dmg
On Ubuntu 17.10, there are issues with flash_tool loading the shared library ‘libpng12’, so this can be used as a workaround:
Ubuntu Dmg Install
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.Choose “Firmware Upgrade” from the drop-down menu.
Warning
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.
Turn your device completely off, but do not connect it yet.
Press the button labeled “Download”.
Perform a final sanity-check that you selected the “Firmware Upgrade” option, not “Download Only”.
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.
Magic happens. Wait till all the progress bars ended.
Ubuntu Dmg Download
Note
Ubuntu Dmg To Iso
If the installation fails with a 100% red bar and hangs there (and logs says something like COMportisopen.Tryingtosyncwiththetarget...
), remove the modemmanager
package as the one installed is not compatible with SP flash tool, close it and try again from step 4.
Linux Ubuntu Dmg
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.