crwdns2915892:0crwdne2915892:0
Before you Begin
- Backup any data from your phone: Make sure that you backup any user data that you don't want to loose. This can include Files, Contacts, Call logs or SMS message logs, 2FA app data, App specific data, Saved account information or login information.
- Find your device on PostmarketOS' Device Page: Some devices will have different processes for entering Flash Mode, and partitioning requirements. Be sure to have the PostmarketOS Device Page for your device is open and handy throughout this guide.
-
-
Open the PostmarketOS Downloads page, and find your device in the device table. You will find options for your device's Stable version, and an option for the Edge version.
-
Once you've found your device, and have selected which image you will be using, you will be brought to a directory page, where you will be prompted to select a user interface.
-
After selecting your user interface you will be presented with multiple files to download.
-
-
-
Each file will have a corresponding checksum in sha256 and sha512. The process will be different between operating systems.
-
To compare checksums on Linux open the terminal and use sha256sum path-to-image-file.img.xz and sha512sum path-to-image-file.img.xz.
-
To compare checksums on MacOS open the terminal and use shasum -a 256 path-to-image-file.img.xz and shasum -a 512 path-to-image-file.img.xz.
-
To compare checksums on Windows open the command prompt and use -hashfile image-file.img.xz SHA256 and -hashfile image-file.img.xz SHA512.
-
Compare the checksums on the website with the checksums of your local files. If they don’t match, you’ll need to re-download the files.
-
-
-
Since the images you downloaded are compressed you will need to extract them. Mac and Windows will have GUI tools for extracting files. Linux will require you to use the command xz --decompress path-to-image-file.img.xz.
-
-
-
-
On Android devices, the standard OS is divided into system, data, and sometimes super partitions (or A/B slots). The system partition (1-2GB, depending on the device’s age) allows quick OS reverts without data loss.
-
However, some user interfaces require more storage, and you’ll quickly run out of space when installing new software or adding new files.
-
The userdata partition: This is the partition used by Android to store user data. If you install to this partition, your Android data will be reset!
-
SD card: On devices with an external storage slot, you can flash the postmarketOS system image onto an SD card.
-
-
-
The following steps outline the general process of flashing images to your device. However, the PostmarketOS device wikis provide additional information or prerequisites specific to your device.
-
-
-
There are a few different options for flashing your SD card, but one of the easiest options is going to be using a software like BalendaEtcher.
-
In Etcher, click "Flash from file" and select the PostmarketOS image you downloaded earlier.
-
Select the USB flash drive as the target device.
-
Click "Flash!" to start the process. Etcher will copy the PostmarketOS to the SD card.
-
-
-
The exact commands vary based on your device and flashing protocol. Ensure your device’s wiki page is open. If there are no specific instructions for flashing to your device’s partition, follow these generic commands.
-
Fastboot:
-
Download fastboot from the Android platform tools or your distro’s package manager.
-
Plug in your device and enter flashing mode.
-
Run fastboot devices to verify device detection. Flash the partition (userdata or system) with fastboot flash PARTITION path-to-rootfs.img.
-
If flashing userdata, wipe the system partition with fastboot erase system.
-
Reboot the device with fastboot reboot to ensure data integrity.
-
-
-
This step only applies to Samsung Devices.
-
Heimdall (Samsung Download Mode/Odin):
-
You'll need to get heimdall from your distro’s package manager or if you're feeling adventurous, build it from source. Alternatively, use pmbootstrap’s chroot; run pmbootstrap chroot apk add heimdall, then execute commands as pmbootstrap chroot heimdall.
-
Enter download mode (usually by pressing the Power + Volume Down + Home buttons).
-
Run heimdall print-pit to list partitions: SYSTEM (system partition), USERDATA or DATA (data partition), and BOOT or KERNEL (boot partition).
-
Reboot the device into download mode.
-
Run heimdall flash —PARTITION path-to-rootfs.img, replacing PARTITION with the partition you listed above.
-
-
-
If you own an Android device, you’ll probably need to flash the boot image or kernel as well.
-
Congratulations on successfully completing the installation process! Once you’ve flashed all the necessary images, reboot the device. If you followed the instructions correctly, you should be greeted with the login screen of your preferred interface. As you finish up you should keep a few things in mind.
Default Username and Password
Default Username: user
Default Password: 147147
Enabling Teletypewriter
TTY/Teletypewriter can be turned on at any point by holding Volume Down and pressing the Power button 3 times.
Downloading Updates
The image you've installed might be out of date slightly, so it is important to run the sudo apk upgrade -U in the terminal to get the latest update.
Using SSH
By default SSH is not enabled from a pre-built image, but can be enabled via the terminal.
Congratulations on successfully completing the installation process! Once you’ve flashed all the necessary images, reboot the device. If you followed the instructions correctly, you should be greeted with the login screen of your preferred interface. As you finish up you should keep a few things in mind.
Default Username and Password
Default Username: user
Default Password: 147147
Enabling Teletypewriter
TTY/Teletypewriter can be turned on at any point by holding Volume Down and pressing the Power button 3 times.
Downloading Updates
The image you've installed might be out of date slightly, so it is important to run the sudo apk upgrade -U in the terminal to get the latest update.
Using SSH
By default SSH is not enabled from a pre-built image, but can be enabled via the terminal.
