Halium devices

First, download the following images:

The last to images are specific to your device. You can either build them yourself using the halium buildsystem, or download a prebuilt one from the server if one is available for your device.

After downloading, you can install the halium system image and the rootfs. For that you can use this halium-install script.

Reboot your device into the TWRP recovery, and use

halium-install -p debian-pm rootfs.tar.xz system.img

to install the images. Please note that you need to use

halium-install -p debian-pm-caf rootfs.tar.xz system.img

to install the images on caf (Qualcomm) devices.

The last step is flashing the hybris-boot.img, which is also a halium part. Depending on the device, you can use fastboot or heimdal to do it.

On fastboot capable devices, it can be installed using fastboot flash boot hybris-boot.img


Download the system image for the pinephone device. This image can directly be flashed to an SD-Card or EMMC chip.

To find out which kernel device was assigned to your SD-Card or EMMC, run sudo fdisk -l and look for the correct device. Once you know the device, for example /dev/sdb, you can flash the image to it using dd.

zcat debian-pinephone-plasma-mobile-testing-arm64.img.gz | sudo dd status=progress of=/dev/mmcblk0

The flashing will take a lot of time depending on the speed of your storage device.

Alternative: If you plan to flash nightly builds often, and don’t need a local copy of the image, you can directly flash the image to your SD-Card using bmaptool:

sudo bmaptool copy --bmap /dev/mmcblk0


If the plasmashell crashes at the first startup, it will not try to place the proper widgets again (taskpanel etc.), as a result you will only see the homescreen after the next reboot, missing some parts.

To workaround this,

  • pinephone: switch the headphone killswitch to off, and connect your headphone serial debugging cable. Then use picocom to connect sudo picocom /dev/ttyUSB0 -b 115200
  • Halium devices: connect the USB cable and ssh into phablet@

You can then log in as phablet / 1234. Then run rm ~/.config/ ~/.config/plasmashellrc.