Installation: Difference between revisions
mention default user / password in the image |
WhyNotHugo (talk | contribs) →Choosing an installation method: simplify explanation |
||
(27 intermediate revisions by 9 users not shown) | |||
Line 1: | Line 1: | ||
This | This page goes over the process of installing postmarketOS on your device. | ||
== What to expect == | |||
{{Hatnote|''See also: [https://postmarketos.org/state/ State of postmarketOS]''}} | |||
In its current stage, '''postmarketOS is for Linux enthusiasts'''. The experience will not be as polished as running Android or iOS. Expect serious bugs like calls not working, SMS not arriving, alarm clock not working, etc. For some devices, primarily in the "testing" category, features like calls may not work at all. Do not use this on your main phone if you rely on its functionality. | |||
It is expected that you are comfortable with using the Linux terminal. On this wiki, you may find commands prefixed with <code>$</code> or <code>#</code>. These characters shouldn't be copied - they indicate whether that command should be run as a regular user (<code>$</code>), or as root (<code>#</code>). | |||
For example, the following tells you to execute the command "ls" as a regular user: | |||
<syntaxhighlight lang="shell-session"> | |||
$ ls | |||
</syntaxhighlight> | |||
== | == Finding your device == | ||
Before you begin installing postmarketOS, make sure to '''read your device's wiki page'''. It contains a lot of useful information, such as a list of supported features and installation methods. You can find it by checking the [[Devices]] list or by using the search feature on the wiki. | |||
If you cannot find your device on the wiki, or if it's listed as non-booting, it is likely unsupported. If you're adventurous, you can follow the [[Porting to a new device|Porting guide]] to add support for your device. | |||
== Choosing a release channel == | |||
{{See also|Releases}} | |||
There are usually two release channels of postmarketOS available: | |||
* '''stable''' - the stable release, based on the latest Alpine Linux version. Currently, the latest stable release is '''{{Latest stable release}}'''. | |||
* '''edge''' - the rolling-release version, based on Alpine Linux's edge repositories. Gets the latest updates as soon as they hit the package repositories, and can thus be less stable. Expect breakages - see [https://postmarketos.org/edge/ postmarketos.org/edge] for more information. | |||
If you're unsure, go with the stable release; you can [[Upgrade to a newer postmarketOS release#Upgrade to another channel|switch to the edge branch]] later. | |||
== Choosing an installation method == | |||
There are two primary methods of installing postmarketOS. You can: | |||
<div style="margin: 1.5em; display: flex; gap: 0.5em; align-items: center; flex-wrap: wrap; justify-content: center;"> | |||
{{Large link box | |||
|icon=Icon-numix-light-drive-multidisk.svg | |||
|target=Installation/Using a pre-built image | |||
|label=Use a pre-built image | |||
|body=<span style="padding: 0 2px 4px; font-size: 1.15em; display: block;">For select devices, mostly from the '''main''' and '''community''' categories</span> | |||
<ul style="text-align: left;"> | |||
<li>Quickest and simplest option - no configuration needed, flash it and you're good to go</li> | |||
</ul> | |||
}}<!-- | |||
--><span style="padding: 0.5em; display: block;">- or -</span><!-- | |||
-->{{Large link box | |||
|icon=Icon-numix-light-applications-engineering.svg | |||
|target=Installation/Using pmbootstrap | |||
|label=Install with pmbootstrap | |||
|body=<span style="padding: 0 2px 4px; font-size: 1.15em; display: block;">For '''all''' devices, including those that do not have images available</span> | |||
<ul style="text-align: left;"> | |||
<li>Provides more customization options: select your own UI, pre-installed packages, options for developers/advanced users</li> | |||
</ul> | |||
}} | |||
</div> | |||
Other options include: | |||
* Installing through the [https://flash.postmarketos.org/ postmarketOS web flasher] - only available for a few devices with pre-built images. Requires a Chromium-based browser (due to its usage of the non-standard WebUSB interface). | |||
* Installing through the recovery using Android-recovery compatible .zip - see [[Installation from recovery mode]] | |||
* Installing through the [https://devices.ubuntu-touch.io/installer/ UBports Installer] (only available for a few devices in the main/community repositories) - select postmarketOS in the OS selection dropdown | |||
=== | == See also == | ||
* [[Dual Booting]] | |||
* [[Upgrade to a newer postmarketOS release]] | |||
* [[Existing Alpine installation]] | * [[Existing Alpine installation]] | ||
* [[Porting to a new device]] | * [[Porting to a new device]] | ||
[[Category:Guide]] | [[Category:Guide]] |
Latest revision as of 02:26, 20 February 2025
This page goes over the process of installing postmarketOS on your device.
What to expect
In its current stage, postmarketOS is for Linux enthusiasts. The experience will not be as polished as running Android or iOS. Expect serious bugs like calls not working, SMS not arriving, alarm clock not working, etc. For some devices, primarily in the "testing" category, features like calls may not work at all. Do not use this on your main phone if you rely on its functionality.
It is expected that you are comfortable with using the Linux terminal. On this wiki, you may find commands prefixed with $
or #
. These characters shouldn't be copied - they indicate whether that command should be run as a regular user ($
), or as root (#
).
For example, the following tells you to execute the command "ls" as a regular user:
$ ls
Finding your device
Before you begin installing postmarketOS, make sure to read your device's wiki page. It contains a lot of useful information, such as a list of supported features and installation methods. You can find it by checking the Devices list or by using the search feature on the wiki.
If you cannot find your device on the wiki, or if it's listed as non-booting, it is likely unsupported. If you're adventurous, you can follow the Porting guide to add support for your device.
Choosing a release channel
There are usually two release channels of postmarketOS available:
- stable - the stable release, based on the latest Alpine Linux version. Currently, the latest stable release is v24.12.
- edge - the rolling-release version, based on Alpine Linux's edge repositories. Gets the latest updates as soon as they hit the package repositories, and can thus be less stable. Expect breakages - see postmarketos.org/edge for more information.
If you're unsure, go with the stable release; you can switch to the edge branch later.
Choosing an installation method
There are two primary methods of installing postmarketOS. You can:
- Quickest and simplest option - no configuration needed, flash it and you're good to go
- Provides more customization options: select your own UI, pre-installed packages, options for developers/advanced users
Other options include:
- Installing through the postmarketOS web flasher - only available for a few devices with pre-built images. Requires a Chromium-based browser (due to its usage of the non-standard WebUSB interface).
- Installing through the recovery using Android-recovery compatible .zip - see Installation from recovery mode
- Installing through the UBports Installer (only available for a few devices in the main/community repositories) - select postmarketOS in the OS selection dropdown