This post is a #wiki, you can edit it by clicking the green pencil icon.
Wiki meta discussion here
How to: Installing LineageOS on your FP3/FP3+
Since there is no easy, complete, all-in-one guide available, I thought about writing one. Feel free to join this wiki post and optimize it;)1. ATTENTION
WARNING: You’ll loose all your data. So back up everything you want to keep!
WARNING: the wiki hasnt been updated since some time and things might have been changed, so def. read the official installation instructions as well ( e.g. LOS recovery to be flashed not bootet…)
2. Requirements
-
Minimal ADB and Fastboot
Command line tool that can handleadb
andfastboot
commands. (Mac users can install them usingbrew install android-platform-tools
) -
Recovery
-
LineageOS recovery
LineageOS recovery, recommended for installing LineageOS. -
LineageOS for microG recovery
LineageOS recovery, recommended for installing LineageOS for microG. -
TWRP
More advanced recovery with e.g. backup options. Can’t be installed permanently, though booting withadb
commands is possible.
-
LineageOS recovery
-
LineageOS
-
LineageOS
Official version of LineageOS -
LineageOS for microG
LineageOS with additional microG services which replaces Google Play Services. F-Droid is preinstalled.
-
LineageOS
-
Optional:
-
Open GApps
If you’re using the original LineageOS and NOT the microG version and want to use Google Services, you can install the Open GApps right after installing LineageOS. -
Magisk
With Magisk you can root your FP3/FP3+ and install additional modules which require root access.
-
Open GApps
3. OEM Unlock
To change the OS, you’ll have to activate OEM Unlock.
-
First of all, you have to enable Developer options:
- Navigate to Settings → About phone → Build number
- Press Build number seven times until you get the message “You have enabled development settings!”
(You might have to enter your PIN/password initially)
-
Next, we have to generate and enter the OEM unlock code:
- Open the website Bootloader Unlocking Code for Fairphone 3
- Navigate to Settings → About phone → IMEI (sim slot 1) and enter the IMEI on the website mentioned above.
- Navigate to Settings → About phone → Model & hardware and enter the serial number on the website mentioned above.
- On the website, press the button Get your unlock code to generate the required code
- Now, you have to activate USB debugging/Android debugging settings:
Navigate to Settings → System → Advanced → Developer options → USB debugging/Android debugging - Then, navigate to Settings → System → Advanced → Developer options → OEM unlocking and enter the previously generated code (You might have to enter your PIN/password initially)
4. Bootloader Unlock
Congrats
You did the first step towards installing LineageOS!
Now we have to use some ADB commands to boot into the bootloader…
- Connect your FP3/FP3+ to your computer and start the terminal app Minimal ADB and Fastboot
(Your Fairphone might ask you first if it should allow USB debugging) - Enter adb devices
This should list your FP3/FP3+ similar like this:
List of devices attached
A208F7120204 device
- Now, enter
adb reboot bootloader
This should boot your Fairphone into the bootloader.
Alternatively, you can turn off your FP3/FP3+, then press the Power button and Volume - button at the same time until the device vibrates. That will also boot your FP3 in to the bootloader.
There you can see on the last lineDEVICE STATE - LOCKED
This indicates that the bootloader is still locked. - Now, enter
fastboot oem unlock
- Next, you have to accept the unlocking on your phone.
Navigate with Volume + / Volume - buttons and press the Power button to proceed with the unlocking.
This step will unlock the bootloader and wipe all your data!
5. Installing LineageOS
To install LineageOS, we first have to boot into a custom recovery. You can use TWRP or the LineageOS-Recovery
- Download your recovery
*download the .img file! - Copy the *.img file into your Minimal ADB and Fastboot install folder (e.g. C:\Program Files (x86)\Minimal ADB and Fastboot)
- Boot your FP3 into the bootloader
- Connect your FP3 to your computer
- Open Minimal ADB and Fastboot and enter the command
fastboot boot RECOVERY-FILENAME.img
Replace RECOVERY-FILENAME.img with the filename of the recovery you want to use.
Now, your Fairphone should boot into the recovery.
6a. Using LineageOS recovery
- Navigate to Factory reset → Format data/factory reset and select it by pressing the power button.
- Now, navigate back to the main menu and choose Apply update → Apply from ADB
- Next, you have to download the LineageOS version you want to use:
download the specific .zip file! - Copy the *.zip file into your Minimal ADB and Fastboot install folder (e.g. C:\Program Files (x86)\Minimal ADB and Fastboot)
- Open Minimal ADB and Fastboot and enter the command
adb sideload lineage-17.1-YYYYMMDD.zip
replace lineage-17.1-YYYYMMDD.zip with the specific filename of the zip file you want to install!
This step will install LineageOS - After the installation is successfully finished, Minimal ADB and Fastboot will report something like:
adb: failed to read command: Success
. - Optional:
If you’d installed the original LineageOS and NOT the microG version and want to use Google Services, you can install Open GApps right after installing the OS.
(same procedure withadb sideload
)
(Since additional add-ons aren’t signed with LineageOS’s official key, the LineageOS recovery might report the warningSignature verification failed.
That’s expected and normal, just continue.) - Now, you can reboot your FP3:
main menu → Reboot system now
6b. Using TWRP
- Navigate to Wipe → Format data and type yes
- Now, Wipe → Advanced wipe and select Dalvik /ART Cache and System
- Now, navigate back to the main menu and choose Advanced → ADB Sideload → Swipe to Start Sideload
- Next, you have to download the LineageOS version you want to use:
download the specific .zip file! - Copy the *.zip file into your Minimal ADB and Fastboot install folder (e.g. C:\Program Files (x86)\Minimal ADB and Fastboot)
- On your computer, enter the command
adb sideload lineage-17.1-YYYYMMDD.zip
replace lineage-17.1-YYYYMMDD.zip with the specific filename of the zip file you want to install!
This step will install LineageOS - After the installation is successfully finished, Minimal ADB and Fastboot will report something like:
adb: failed to read command: Success
. - Optional:
If you’d installed the original LineageOS and NOT the microG version and want to use Google Services, you can install Open GApps right after installing the OS.
(same procedure withadb sideload
) - Now, you can reboot your FP3:
Reboot → System
6. Rooting your FP3/FP3+ (optional)
This may break some features on your phone, only root your phone if you are sure of what you are doing
After installing LineageOS, you might want to get some more features with rooting you FP3/FP3+. This is quite easy to achieve:
- Download Magisk Manager (MagiskManager-v0.0.0.apk) to your phone.
- Download Magisk (Magisk-v00.0.zip) and copy the file into your Minimal ADB and Fastboot install folder (e.g. C:\Program Files (x86)\Minimal ADB and Fastboot)
- First, open and install the Magisk Manager apk file from your phone with the file manager.
- Then, boot into the recovery with the command
adb reboot recovery
- Connect your FP3/FP3+ with your computer, open Minimal ADB and Fastboot and install the Magisk .zip file with the command adb sideload Magisk-v00.0.zip
Replace Magisk-v00.0.zip with the filename of the specific file.
(Since additional add-ons aren’t signed with LineageOS’s official key, the LineageOS recovery might report the warningSignature verification failed.
That’s expected and normal, just continue.) - Now, reboot
7. Relock Bootloader (optional)
After installing LineageOS, you can lock your bootloader again. Be aware that this will wipe all your data!
WARNING: If you have rooted your FP3/FP3+, you can’t lock the bootloader!
- Boot your FP3 into the bootloader with the command
adb reboot bootloader
- Connect your FP3 with your computer and open Minimal ADB and Sideload.
- Type the command
fastboot oem lock