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
PinePhone
Installation
This document guides the user how to install Mobian on their PinePhone.
Prerequisites
Mobian on the PinePhone requires that Tow-Boot is installed on the mmcboot partition of the device's eMMC. Users should follow the "Installing to eMMC Boot guide in the Tow-Boot documentation before proceeding.
Obtain the image
Pre-built Mobian images for the Pinephone can be downloaded from this link. Installer images are available here.
Verifying the images
Mobian images come with multiple files:
- .img.gz: The flashable image
- .img.bmap: The bmaptool input for the image (See Method 1a below)
- .sha256sum: A file of SHA256 hashes of the image file.
- .sha256sum.sig: A detached signature for the .sha256sum file.
To verify the download, use the following steps:
Import the Mobian signing key from here. Once downloaded, the key can be imported with gpg --import mobian.gpg.
Verify the signature with gpg --verify <downloaded file>.sha256sum.sig.
If the signature is valid, check the other files with shasum -c <downloaded file>.sha256sums
- If this prints OK for all files the download is verified.
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 16GB or 32GB depending on your device model) 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 or by flashing the installer image to an SD card which will then provide the option to install to eMMC.
To use ?JumpDrive:
- - Download the Jumpdrive image and flash the Jumpdrive image to a micro SD card
- Boot the PinePhone from the ?JumpDrive micro SD card - Connect the PinePhone to your computer using a USB cable - The SD card and the eMMC will become available as block devices on your computer (in the form of /dev/sdX block devices). - Flash the exposed (mounted) PinePhone drive with the Mobian image using one of the methods below. - Disconnect the PinePhone from your computer and remove the Jumpdrive SD card - Power in the PinePhone and boot Mobian from eMMC.
Note: It is not recommended to flash the installer directly to the eMMC. If you do install this way, please ensure there is no SD card present while running the installer.
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
sudo bmaptool copy https://images.mobian-project.org/pinephone/CHANGEME $BLOCKDEVICE
with $BLOCKDEVICE the blockdevice to flash, e.g. /dev/mmcblkX, /dev/sdX [in the case of jumpdrive], or /dev/disk/by-id/XXXXXX).
Example:
sudo bmaptool copy https://images.mobian-project.org/pinephone/nightly/mobian-pinephone-20200517.img.gz /dev/disk/by-id/mmc-SU16G_0x1d6654fd
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
- sudo bmaptool copy $IMAGE $BLOCKDEVICE
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/).
Example:
- sudo bmaptool copy mobian-pinephone-20200801.img.gz /dev/disk/by-id/mmc-SU16G_0x1d6654fd
Method 3: dd
To use dd, you need to unzip the image using one of the following commands:
- gunzip mobian-pinephone-YYYYMMDD.img.gz gzip -d mobian-pinephone-YYYYMMDD.img.gz
Then flash with the following command:
- sudo dd bs=64k if=mobian-pinephone-YYYYMMDD.img of=/dev/mmcblkX status=progress
(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 is locked by default.
You should change the user password - 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.