Jump to navigation Jump to search
clarification. Images itself don't get decompressed
This page contains a list of all available releases for the [[PinePhone]] as well as links to other resources.
See [[PinePhone Installation Instructions]] on how to install the operating systems.However, if your phone came preloaded with software, Please see [[PinePhone Updating Instructions]]
{{Hint| Note: Some releases may not have a good setup for the backlight at low brightness. If configured too low the backlight shuts down completely, but the screen is still displayed and usable in bright front-light.}}
= Software Releases =
== Arch Linux ARM ==
<div style=float:right>[[File:Archlinux-logo.png|100px]]</div>
(Unofficial) Arch Linux ARM with choice of Phosh UI or barebones, currently being maintained by the [ DanctNIX ] community(GitHub [ 1] [ 2]).
'''Download location'''
'''What works, what does not work'''
Most of the things now works, there are some minor issues with [[crust]].
'''How to contribute and report defects'''
'''Download location'''
Check the [ download page] for that lastest verisonlatest version, or the [ image file list] for all versions, look for the file name that starts with "pinephone".
== Fedora ==
<div style=float:right>[[File:Fedora-logo.png|100px]]</div>
An (unofficial) vanilla Fedora rawhide build for aarch64 with megi's kernel and [ some additional packages] to tie it all together. It aims to eventually be an upstream part of the Fedora project, rather than a phone-specific distribution.
[ flashable images] or [ build scripts]
There is also an FTP server with full a full Fedora 34 workstation build with phosh: (Mount this with something like Nautilus)
'''How to contribute and report defects'''
Please send your bug reports at to [ the project's issue tracker]. Be sure to include logs if applicable! Send us merge requests on [ Github].
== Gentoo ==
<div style=float:right>[[File:GentooLogo.png|100px]]</div>
There are unofficial Gentoo overlays with ebuilds for the PinePhone. There are no images - you'll be building it yourself, picking which kernel, bootloader and desktop environment you want to use.
You will be using the [ arm64] version of Gentoo.
'''Documentation''' (incomplete)
An unofficial Gentoo overlay with ebuilds for the PinePhone. There is no image - you'll be building it yourself, picking which kernel, bootloader and desktop environment you want to use.''Overlay locations'''
'''Download location'''
== GloDroid ==
Works: WiFi, screen dimming, touchscreen and charging work.
Don't work: Bluetooth, Telephony, GPS
== KDE Neon ==
{{Warning|The development images of Plasma Mobile have shifted to Manjaro Plasma Dev. KDE Neon currently uses outdated git release versions of Plasma Mobile and is NOT maintained.}}
Based on KDE Neon for the desktop, comes with Plasma Mobile.
'''Download location'''
Plasma mobile images can be found [ here].
== LuneOS ==
[ LuneOS test image for PinePhone]
Tofe recommends using It is recommended to use <i>bmaptool</i>, which is way faster than dd, and can decompresses compressed images decompress archived image files on-the-fly.
Syntax is:
<code>bmaptool copy [from] [to]</code>
For example:
<code>bmaptool copy /dev/mmcblk0</code>
.wic file can be treated as .img file when flashing. You may rename .wic file to .img when using GUI tools that require .img files.
== Maemo Leste ==
<div style=float:right>[[File:Maemoleste-logo.png|100px]]</div>
[ Maemo] is a trimmed-down version of Debian for mobile devices, originally a collaboration between Nokia and many open source projects (the [ Maemo community]) before Nokia abandoned it. The community now takes full responsibility in developing fully open source Maemo for a variety of mobile devices.
'''How to contribute and report defects'''
Most discussion occurs at <i>#maemo-leste </i> on freenode IRC<i></i>. The Maemo website also has an [ ongoing forum thread] for feedback about Maemo Leste on the PinePhone Braveheart edition.
All other contact information is listed on the [ main page] of the Maemo wiki. You should [ submit bug reports] on github. To track known issues, you may use these search terms: [ pinephone], [ pine64]. Learn about [ development], [ porting packages], [ building packages], [ todo list], and general info on [ how to package for Debian]. Some tasks have funding available.
== Manjaro ARM ==
<div style=float:right>[[File:Manjaro-logo.svg|100px]]</div>
Manjaro is a user-friendly Linux distribution based on the independently developed Arch operating system with the Plasma Mobile desktop environment.
'''Download location'''
*Phosh: [ Stable] / [ Dev] *Plasma Mobile: [ Stable] / [ Dev] *Lomiri: [ Dev]
'''What works, what does not work'''
{{Hint| Note: The Phosh image the boot will load at a TTY login prompt for multiple minutes at the first boot.}} See Manjaro's release announcements on their forum. Recent ones: [ announcement62260 Phosh], [ Plasma] and [ Lomiri].
'''How to contribute and report defects'''
== Mobian ==
<div style=float:right>[[File:Debian-logo.png]]</div>
An unofficial Debian build for ARM64 running with the Phosh user interface (developed by Purism, Phosh uses Wayland instead of Xorg). The base system is pure Debian, with only the GUI applications and a few others (ModemManager, WiFi chip firmware) being built from modified sources (as well as the kernel and u-boot). Current version is Debian Bullseye.
Don't forget to extract the image before installing:
 <code>$ gzip -d Downloads/mobian-pinephone-*.img.gz</code>
See the [ project page] for specific installation instructions.
== Nemo Mobile ==
<div style=float:right>[[File:nemo_mobile.png|right|100px]]</div>
Nemo Mobile is the open source build of Sailfish OS with a open source UI called [ Glacier] ([ Mer Wiki]), now [ based on Manjaro]. See their website [ Nemo Mobile UX team] and [ Mer Wiki page].
You can either install Nemo on any device that already runs Sailfish, or flash a prebuilt image to SD card/emmc on the PinePhone to install.
'''Download location'''
{{Hint| Note: See their website for the newest release and installation guides.}}
Prebuilt images:
First devel image for Manjaro (April 1, 2021):
* Offical blog post: [ First devel image for manjaro]
* Image locations:
** devel:
** ?:
* Packages:
Nemo Mobile is the open source build of Sailfish OSwith Glacier UX v0.8 (April 27, see the new website
You can install * Offical blog post: [ Nemo on any device that runs Sailfish, see the above website for detailsPinePhone v0. Or you can flash the 8]* rootfs image to SD card: https:/emmc on the PinePhone, download here /* 2GB sdcard image: (requires Yandex Disk account).
'''Download location'''Install Nemo on Sailfish:
Download location is Install Sailfish on your PP first (follow instructions on the [[ here PinePhone_Software_Releases#Sailfish_OS|Sailfish]] section on GitHub]this page). The latest version is not an image file and therefore not for beginners!
Alternative easy installation method: install Sailfish on your PP first (follow instructions on this page under Sailfish). Enable developer mode.In the terminal , run as root (`devel-su`):
<code>ssu ar nemo-devel-ux</code>
<code>pkcon refresh</code>
then install the nemo-specific Glacier packages:
<code>pkcon install lipstick-glacier-home-qt5</code>
If necessary, reboot.
'''What works, what does not work'''
Scroll down For the page newer devel image based on Manjaro, [ Wi-device-dont_be_evil/ hereFi and Bluetooth works]. For the older Nemo with Glacier UX v0.8, voicecalls, sound and cameras do not work by default, see its blog post and GitHub repo readme.
'''How to contribute and report defects'''
For more info please visit [the Nemo Mobile UX itself:* GitHub issues: For hardware:* GitHub issues: neochapay's Github page]/issues
== NixOS ==
<div style=float:right>[[File:nixos.png|right|100px]]</div>
NixOS support is handled through the Mobile NixOS project.
== openSUSE ==
<div style=float:right>[[FileImage:SLEM-OS-logo.png|100px|link=]]</div>
openSUSE Tumbleweed running on Our images use the PinePhonesame [https://en.opensuse. Uses the same org/Portal:Tumbleweed openSUSE Tumbleweed ] base as our desktop images, except what needs to be changed for the PinePhone. The images include <i>zypper</i> (RPM) as the default package managerand have access to virtually the same (open source) software as our desktop repositories, thanks to the [ Factory] ports. Using [ dnf] is possible, if preferred.
'''Download links'''
* [ StableopenSUSE-Tumbleweed-ARM-PHOSH-pinephone.aarch64.raw.xz Phosh] / [ SHA-256] / [ SHA-256 Signature]* [ Plasma Mobile] / [ SHA-256] / [ DevopenSUSE-Tumbleweed-ARM-PLAMO-pinephone.aarch64.raw.xz.sha256.asc SHA-256 Signature] To verify the images you need to import [ our GPG key]. Keep on mind that the first boot may stay on black screen for about a minute - consequent boots should be faster. You can find install instructions at [ this section] in the openSUSE Wiki.
The login credentials are pine/1234 and root/linux. Change (or disable) the root password once you are set up.
'''What works and what does not work'''
You can find all information about the releases of the project [ here].
Detailed information, tips and troubleshooting suggestions are also provided at [ the openSUSE Wiki].
You will also find information in our wiki on how to report issues (Contributing section).
== postmarketOS ==
<div style=float:right>[[File:PostmarketOS-logo.png|100px]]</div>
postmarketOS extends [ Alpine Linux] to run on smartphones and other mobile devices.
'''Download location'''
Edge: [ Phosh] / * [ Plasma Mobile] / [ SXMODownload pagev20.05 (Stable): [ Phosh] (* [ Downloading the right imageInstallation Flashing instructions])
== PureOS ==
<div style=float:right>[[File:Pureos.png|100px]]</div> 
{{Warning|This project is no longer under development and has been abandoned.}}
== Sailfish OS ==
<div style=float:right>[[File:Sailfish_logo.png|150px]]</div>
[ Sailfish OS] is a Linux-based operating system based on open source projects such as [ Mer], and a closed source UI based on [ Lipstick].
# Follow the instructions. Some commands in the script require root permissions (for example: mounting and flashing the SD card).
* When asked where to flash, type 'raw' and it will build the image on your computer. '''Prebuilt image'''Otherwise define the path /dev/.... to flash to card or internal emmc.
Download the image file (.img) from [].
* The homescreen may be locked unless you boot with a sim card inserted. An old expired sim will do. '''If you do not have a SIM card on hands, do NOT set a security code on first boot.'''
* When a screen with a loading circle is displayed, just left/right swipe it away.
* If you're not familiar with Sailfish OS, pay attention to the tutorial - the interface works great, but is not immediately obvious. If you are familiar with it, you can skip the tutorial by touching all 4 corners starting top left.
'''What works, what does not work'''
See the [ Hardware Support section] on the Mer Wiki's PinePhone Page.
There is a limited selection of apps available from the Jolla store, the vast majority are hosted on The If the Storeman app for openrepos is now not preinstalled, download the RPM and also Webcat browser (the built-in browser) is not working at the momentclick to install.
'''How to contribute and report defects'''
OTA is supported: <code>zypper refresh && zypper update</code> as root (<code>devel-su</code> to get root access). Things that need reflash are bootloader specific at the moment. If improvements like [[crust ]] or changes of partition layout are added, then you need to reflash.
== SkiffOS ==
<div style=float:right>[[File:SkiffOS-Icon-1.png|100px]]</div>
[[File:SkiffOSMinimal in-Iconmemory cross-1compiled OS optimized for hosting multiple in parallel Docker containers.png|100px]]
Minimal inProvides the reliability of firmware with the ease-memory crossof-compiled OS optimized for hosting other distributions in Docker containersuse of package managers.
Provides Upgrade over-the reliability of firmware with the ease-of-use of package managersair via a simple rsync script, or copying 3 files.
Uses the [ Buildroot] cross-compilation tool for support for all Pine64 boards.
* core/pinephone_neon: KDE Neon via Ubuntu repositories
* core/pinephone_nixos: Nixos Mobile
* core/pinephone_gentoo: Gentoo with Link-time Optimization & KDE Mobile or Phosh
* core/pinephone_ubports: Ubuntu Ports for PinePhone
* core/pinephone_manjaro_kde: Manjaro for PinePhone: KDE variant
* core/pinephone_manjaro_lomiri: Manjaro for PinePhone: Lomiri variant
You can also configure the skiff core yaml file to configure multiple distros to run in parallel.
The boot-up OS can be is upgraded independently from the containers.
'''Download location'''
'''Download location'''
Sxmo images can be found [ here](in the <i>/pine64-pinephone/sxmo/</i> sections respectively).
mouser/mo '''What works, what does not work''' PinePhone's backlight turns off at 2/10 brightness.147147
'''How to contribute and report defects'''
== Ubuntu Touch ==
<div style=float:right>[[File:Ubports-logo.png|100px]]</div>
A Mobile Version of the Ubuntu Operating System made and maintained by the UBports Community.
See [ UBports gitlab page]. See [ UBports website] for how to donate.
= Tools =
There are software tools, that can be booted on the PinePhone.
== JumpDrive ==
JumpDrive can be used to flash the eMMC (and the microSD card), see [[PinePhone Installation Instructions#Using JumpDrive]].
See for the latest image. Make sure to download the "PinePhone" image and to unpack the archive before flashing.
= Factory Test OS =
Download the build, extract the image and dd it to the microSD and then insert it into the phone. Power up the PinePhone, perform and complete the test routine, then apply the build from microSD card to eMMC.
dd the image on a 8 GB micoSD microSD card or larger.
{| class="wikitable"
! File Size
! MD5
| Beta Edition
| [ Direct download from]
| 1.78GB
| f16bce93504a52217540ac886863a418
| Mobian
| [ Direct download from]
| 1.41GB
| 015be381ff4e650a7fca6d4eaa90d63d
| [ Direct download from]
| 2.28GB
| 32979ff17b5ec4d358ce99f1aff0c77c
| Manjaro
| [ Direct download from]
| 1.04GB
| 4edfd4dceaefdd32a3417c1727161c29
| postmarketOS
| 1.05GB
| 2d7f5271e7a281db8f1b1219bedbe131
| Manjaro
| [ Direct download from]
| 1.04GB
| 4edfd4dceaefdd32a3417c1727161c29
= Installing other ARM64 distributions =
'''Warning:'''Distributions not on this page may not even boot after you follow this section. In the best case, they will be barely usable. This is more for fun, or if you would like to port a new distribution to the PinePhone.
{{Warning|Distributions not on this page may not even boot after you follow this section. In the best case, they will be barely usable. This is more for fun, or if you would like to port a new distribution to the PinePhone.}} {{Hint|'''Note:'''This section uses megi's kernel releases, and not the official ones from Pine64. While it is possible to use the official (and in the future, mainline) kernel, megi provides binary releases, which makes it very easy.}} If you would like to see specific commands for how to complete these steps, see:* (an example for Fedora) or* (an example for Arch Linux).
If you would like to see specific commands for how to complete these steps, see httpsGeneral step:// (an example for Fedora) or (an example for Arch Linux).
# Create a boot (from 4 MB to about 252 MB) and root (from 252 MB the end of boot to the end of the card) filesystem on the SD card.# Format the boot partition with vfat, and the root partition with a supported filesystem like ext4 or f2fs.# Extract the root filesystem from your distribution's ARM image into the root filesystem on the SD card. Do not copy the partition, copy the files (in archive mode: like <code>rsync -ar</code>).# Edit <code>/etc/fstab </code> to match your partitions.
# Grab megi's kernel from
# Follow the README instructions, which involves copying the kernel modules into the SD card rootfs , and writing u-boot and the bootloader.
= Other Resources =
Hardware information
* [[PinePhone|General PinePhone hardware info]] in this Pine64 wiki.* Details specific to the Braveheart Edition: [[PinePhone_v1.1_-_Braveheart|PinePhone 1.1 Braveheart hardware details]] (details * Details specific to the Braveheart Community Edition).* : [[PinePhone_v1.2|PinePhone 1.2 hardware details]] (details specific to the Community Edition).* The postmarketOS wiki has a detailed page on the PinePhone hardware [ here] and the preceding devkit [ here].
Other software information
* [ sunxi community wiki]
* [ megi's feature/driver support matrix]
* [ megi bootUI notes (for dualbooting/multibooting)] see demonstration [ on YouTube,]
* [ ayufan boot tools]


Navigation menu