meta data for this page
  •  

This is an old revision of the document!


Installing Mobian (Android devices)

This guide covers installing Mobian on the OnePlus 6/6T and Pocophone F1. See the devices page for the full list of supported devices.

Obtain the Image

Pre-built Images

We recommend downloading pre-built images for installation. The image files for your device will be packed in a file named mobian-<device>-phosh-YYYYMMDD.tar.gz and can be found here:

Building from Debos Recipes

You can build the image yourself using the debos recipes. If you build the image yourself, the produced image file will be not be zipped (i.e. named mobian-<device>-phosh-YYYYMMDD.*.img) and there is no need to unzip the archive.

Preparing the device

As you would do before installing a custom Android ROM, the bootloader needs to be unlocked. The exact procedure varies depending on the device you own, so we suggest you search the Internet for an unlock guide aimed at your specific device.

We also recommend that you upgrade Android to the latest available version and install all system updates before installing Mobian.

Flashing the Image to the Target Device

WARNING: Flashing Mobian to your device will wipe your Android installation! Please install a recovery software such as TWRP and make sure you understand how to recover your system before proceeding

Those devices being Android smartphones in the first place, they have secure boot enabled, meaning we can't replace their bootloader and need to rely on Android tools in order to flash Mobian.

In practice, this means we can't flash a single image file, and the the downloaded tarball will contain:

  • an Android bootimg containing the kernel, device-tree and initramfs named mobian-<device>-phosh-YYYYMMDD.boot-<variant>.img
  • an F2FS-formatted rootfs (using Android's sparse image format) named mobian-<device>-phosh-YYYYMMDD.root.img

As these devices have several variants, which differ only by the device-tree they need, and the DT being part of the bootimg, we provide one bootimg for each variant. You have to flash the one matching your device:

  • OnePlus 6: enchilada
  • OnePlus 6T: fajita
  • Pocophone F1: use the beryllium-tianma variant first; if the display never shows up, then switch to the beryllium-ebbg variant

Once you have extracted those files from the tarball, boot your device into Fastboot mode, connect it to your computer using a USB cable and run the following commands to install Mobian:

fastboot flash boot mobian-<device>-phosh-YYYYMMDD.boot-<variant>.img
fastboot -S 100M flash userdata mobian-<device>-phosh-YYYYMMDD.root.img
fastboot erase dtbo

Notes:

  • If the device becomes unresponsive after a fastboot command succeeded, power it off and boot into fastboot mode again, then execute the remaining commands.
  • The OnePlus 6/6T has an A/B partition scheme. In order to select which slot you want to flash Mobian to, you can run the following command before any other fastboot command:
fastboot --set-active=[a|b]