Skip to content

Latest commit

 

History

History
57 lines (41 loc) · 3.52 KB

FLASHING.md

File metadata and controls

57 lines (41 loc) · 3.52 KB
Raw

Flashing guide

Table of Contents

Disclaimer

#include "disclaimer.h"
/*
 * I am NOT responsible for you getting fired because the alarm app failed or if you destroy your device.
 * Please do some research if you have any concerns about features included in this port.
 * Same security standards as for official Sailfish OS devices may not apply here.
 * Everything is served on an as-is basis and YOU are choosing to do these modifications.
 */

WARNING: All current data on the device WILL be erased, so be sure to make full data & NANDroid backups before proceeding!

Unlocking the device

Check out this forum post, rooting can be ignored as the system will be wiped fully anyways afterwards.

Firmware & TWRP

When using Sailfish OS the current port expects the phone to have Android 9 Pie firmware.

  1. Fetch the files for latest O2OS 9.0.11 firmware (OP5 / cheeseburger | OP5T / dumpling) and a TWRP >=3.3.x image.
  2. Flash the firmware zip first and then TWRP image to Recovery partition.
  3. First time flashers should also check /data for filesystem issues (make sure it's unmounted & formatted as ext4 beforehand!):
ADB_SHELL # e2fsck /dev/block/bootdevice/by-name/userdata
  1. Before rebooting back to recovery make sure to "Format data"!

Flashing steps

  1. Clear data & caches (factory reset)
  2. Flash a recent official LineageOS 16.0 zip (OP5 / cheeseburger | OP5T / dumpling)
  3. (Optional) Flash whatever else you normally have on the Android side (e.g. OpenGApps, Magisk, disable dm_verity & force-encrypt etc)
  4. Flash your desired sailfishos-*.zip from the pipeline artifacts (OP5 / cheeseburger | OP5T / dumpling); normally takes ~1 min 30 sec)
  5. Reboot

Skipping the tutorial

Once booted for the first time Sailfish OS will always start off with a tutorial screen. Since you'll likely be flashing zips many times, this will become very annoying rather quickly. You can skip this by tapping each corner of the screen once starting from top-left going clockwise.

Dual-booting with LineageOS

What makes SFOS unique as well is that it doesn't actually touch your /system partition (and /vendor once I figure stuff out :p), which makes it super easy to dual-boot!

When you've flashed a Sailfish OS zip you can swap between the operating systems without needing wiping anything by simply flashing my boot-switcher zip within TWRP.