DebianOn is an effort to document how to install, configure and use Debian on some specific hardware. Therefore potential buyers would know if that hardware is supported and owners would know how get the best out of that hardware.

The purpose is not to duplicate the Debian Official Documentation, but to document how to install Debian on some specific hardware.

If you need help to get Debian running on your hardware, please have a look at our user support channels where you may find specific channels (mailing list, IRC channel) dedicated to certain types of hardware.

Models covered


This document guides the user how to install Mobian on their phone (currently only Pinephone).

Obtain the image

You can either download pre-built images from this link (recommended). In this case, the image file is named "mobian-pinephone-YYYYMMDD.img.gz". Once you have obtained an image, you can flash it to a SD-card or to internal eMMC storage.

Note: If you decide to use bmaptool, you don't have to download the image manually (see below).

Note2: If you built the image yourself using debos recipes, the image file will be named "mobian-pinephone-YYYYMMDD.img" and there is no need to unzip it.

Flash the image

In order to flash the Mobian image, you need to identify the device attached to target. On the pinephone, it is /dev/mmcblk0 (for SD) or /dev/mmcblk2 (for eMMC, its size should be around 16GB) You can also use device names by-id for increased safety, e.g. /dev/disk/by-id/mmc-SU16G_0x1d6654fd. **Be careful not to write to the wrong device! Replace the "X" in /dev/mmcblkX or /dev/sdX or use /dev/disk/by-id/.**

Follow below steps on how to flash to emmc or see these pine64 wiki instructions for more ways on how to access emmc of the pinephone. To flash a SD card, simply use a computer of your choice.

Be advised that the first boot will take longer due to the ?automatic resizing of the filesystem.

Installation to eMMC

You can install the image to eMMC by using JumpDrive.

Method 1a: bmaptool using an URL

bmaptool is a comfortable means to flash your image. It handles sparse files, so it can be considerably faster than plain dd. It also handles both .bmap and .gz files and can dowload them directly from an URL. Execute

with $BLOCKDEVICE the blockdevice to flash, e.g. /dev/mmcblkX, /dev/sdX [in the case of jumpdrive], or /dev/disk/by-id/XXXXXX).


Method 1b: bmaptool with a local image file

You can also use bmaptool to flash a local image. As it handles sparse files, it can flash considerably faster than plain dd

with $IMAGE, the path to the compressed or uncompressed image file and $BLOCKDEVICE the blockdevice (/dev/mmcblkX or /dev/sdX - if you are using jumpdrive - or /dev/disk/by-id/).


Method 3: dd

To use dd, you need to unzip the image using one of the following commands:

Then flash with the following command:

(the status= option will display some progress while flashing, dd is awfully silent otherwise)

Default pin and password

The default user is **mobian** and has the password: **1234**. It is also used as PIN on the unlock screen.

The root-user has the default password: root

You should change both - please see ?changing password about the right way to do so. If you want to access your phone via ssh, you need to ?set it up to do so.

Automatic resizing of your filesystem on first boot

After flashing the image and booting for the first time, Mobian will resize the root filesystem to take all possible space on the disk. This can take a while and will only happen on first boot. So grab a ${DRINK_OF_CHOICE} and be patient.

Other reports