Edit page

Installation to the microSD card

For this installation method you need a microSD card, a microSD card reader and a compatible device, such as a computer or a laptop with Linux, iOS, Windows or similar (note: ChromeOS is not supported).

To install an image to the microSD card:

  1. Download your chosen image from Operating systems for the regular PinePhone and Releases for the PinePhone Pro

  2. Extract the compressed file

  3. Write (flash) the image to your microSD card, see the isntructions below

  4. Plug microSD card into phone (make sure to use the top slot, not the bottom slot)

  5. On the PinePhone Pro: The eMMC might have to be overruled to boot from the microSD card, see PinePhone Pro

  6. Boot up the phone

The microSD belongs in the upper slot

Flashing the microSD

Using Balena Etcher

Using the graphical application Balena Etcher to flash the microSD card is 'recommended' for new or inexperienced users.

Install the application and start it.

Click the button Flash from file:

Etcher1

Select the downloaded image and make sure that you downloaded the correct one. Images for the PinePhone and the PinePhone Pro are 'not compatible' with each other. Images for the PinePhone typically have the word "PinePhone" in the filename, while images for the PinePhone Pro typically have "PinePhone Pro" in their filename.

At this the image file does not have to be extracted from the archive format. Balena Etcher handles the extracting automatically.

Then click on Select target:

Etcher3

Make sure to select the correct target by comparing the name and the disk capacity with the label on the microSD card.

Then click on Flash!:

Etcher4

That’s it! Now follow the further instructions above.

Using dd

Make sure to select the correct device using lsblk. Then run dd with the selected device:

sudo dd if=IMAGE.img of=/dev/[DEVICE] bs=1M status=progress conv=fsync

The image needs to be written to the whole device, not to partition 1. Make sure you’re NOT selecting /dev/sda1 or /dev/mmcblk0p1 as target.

Using bmaptool

Make sure to select the correct device using lsblk. Then run bmaptool with the correct device:

Download the IMAGE.xz and the IMAGE.bmap files, then run bmaptool copy --bmap IMAGE.bmap IMAGE.xz /dev/[DEVICE]. This takes around 2.5 minutes to flash a 4 Gb file.

Using Gnome Disks

Gnome Disks can be used to flash the microSD card. To do so, select the correct device in the left device selection, then click on the three dot menu and select Restore Disk Image…​ and follow the on-screen instructions.