Commit d43bd64f authored by Dalton Durst's avatar Dalton Durst

Add documentation of images and installation

parent 36ce3b84
# PinePhone
Project management and issue tracking for the Pine64 PinePhone port of Ubuntu Touch
\ No newline at end of file
This repository is used for documentation, issue tracking, and project management for the [Pine64 PinePhone]( port of Ubuntu Touch. Unlike the other Community Ports repositories, it does not contain Android binaries for building system images.
## How do I install Ubuntu Touch on my PinePhone?
Please note that our PinePhone images are currently **not suitable for daily use**. See [this repository's Issues tab][] for more information. You must reinstall using these instructions often.
You will need a microSD card, 4GB or larger.
1. Download `ubuntu-touch-pinephone.img.gz` from [the latest rootfs-pinephone build on UBports CI](
1. Extract `ubuntu-touch-pinephone.img.gz` to receive a 4GB file, `ubuntu-touch-pinephone.img`.
1. Flash `ubuntu-touch-pinephone.img` to your microSD card using [balenaEtcher](, Disk Image Writer, `dd`, or another method you are comfortable with.
1. Insert your microSD card into the slot on the rear of the PinePhone.
1. Boot your PinePhone.
It will eventually be possible to install Ubuntu Touch on the PinePhone via the UBports Installer. However, this method will likely perform the same steps as outlined here. Currently, we do not have a PinePhone in the hands of developers interested in the installer. This will change soon.
## How is the PinePhone image built?
Unlike our other supported devices, the PinePhone does not require the use of Android drivers or services. Therefore, building Halium for this device is not required. Instead, we build the images for the PinePhone using the `debos` configuration found in [ubports/core/rootfs-builder-debos on GitLab]( See the `pine64-common.yaml` and `pinephone.yaml` files for the configuration, see the repository's `` file for information on building the images yourself.
The lack of Android also causes its own problems, which are tracked via the Issues page of this repository.
Additionally, we use the Mesa drivers to run on the PinePhone. The Mir backend for Mesa does not support Mir-on-Mir, which is used by all other supported devices to run applications. Applications running on the PinePhone use the Wayland protocol, not MirAL, to speak to Mir. Therefore, all of the issues posted in the [Waylandify project on UBports' GitHub]( affect Ubuntu Touch on the PinePhone.
## How does this repository work?
We track issues which are specific to the PinePhone in [this repository's Issues tab][]. We also add issues here which affect devices that do not use Android, but do not have their own tracker. For example, ["Image-based upgrades are not available"]( affects all devices that do not use Android. However, there is currently no other place to put this issue on GitLab. It fits best here because the PinePhone is the most popular non-Android device, and the one people have the most questions about.
## How do I help make Ubuntu Touch on the PinePhone better?
Installing Ubuntu Touch on your PinePhone then reporting the issues you find here is a great first step! If you're not sure if an issue belongs here or somewhere on GitHub, you can contact us via any of our standard chats or forums:
* [UBports Forum](
* `#ubports` on freenode IRC
* `` using Riot, FluffyChat, or your favorite Matrix client
* `@ubports` on Telegram
[this repository's Issues tab]:
Markdown is supported
You are about to add 0 people to the discussion. Proceed with caution.
Finish editing this message first!
Please register or to comment