Install /e/ on a Fairphone FP3/3+ - “FP3”

Tip: Please read through the instructions at least once before actually following them, so as to avoid any problems later.
Caution: Flash your device only if you know what you are doing and are OK taking the associated risk. The /e/ project and its project members deny any and all responsibility about the consequences of using /e/ software and or /e/ services.

Requirements

  • Take a backup of all important data on your phone before proceeding.
  • Ensure your phone is charged more than 50%
  • Check that adb and fastboot are enabled on your PC. If not you can find the setup instructions here
  • Download all the files and images mentioned in the download section below before starting the installation
  • Make sure you have a working data cable to connect your device to the PC. There are cables which are only for charging and do not transfer data.
  • Enable USB debugging on your device. You can find the instructions here
Caution: Before following these instructions please ensure that the device is on the latest Android firmware. For example to install to /e/ Q the Android firmware should be Android 10 and for /e/ Pie it should be Android 9

Downloads for the FP3

Warning: Please note some of the above links can lead to external sites

Unlock the bootloader

  • Allow the bootloader unlocking by following the official FP3 unlock documentation
  • Reboot the device on fastboot mode by running adb reboot bootloader (or press Power + Volume - if your device is off)
  • Once on fastboot mode, unlock the device by running fastboot flashing unlock

    On previous versions of fastboot, the command is fastboot oem unlock

  • The device will ask you to confirm the unlocking. Confirm by selecting UNLOCK THE BOOTLOADER and confirm with Power
  • The device reboot automatically. It will show a warning. Press Volume + or Volume - to display boot options, select fastboot and confirm with Power to reboot on fastboot

Installing /e/ from the bootloader

Tip: Some of the commands have a -S after them. Please note it is a hyphen ‘-‘ followed by a capital ‘S’ and the value 522239K
  1. Unzip the archive

     unzip <zip>
    
  2. Install /e/ using the following commands (from fastboot mode)

     fastboot -w
     fastboot flash system_a system.img -S 522239K
     fastboot flash boot_a boot.img
     fastboot flash vendor_a vendor.img -S 522239K
     fastboot flash dtbo_a dtbo.img
     fastboot flash vbmeta_a vbmeta.img
    
     fastboot flash system_b system.img -S 522239K
     fastboot flash boot_b boot.img
     fastboot flash vendor_b vendor.img -S 522239K
     fastboot flash dtbo_b dtbo.img
     fastboot flash vbmeta_b vbmeta.img
    
     fastboot flashing lock
    
    • The last command will ask you to confirm on the device to lock the bootloader.

    • Select LOCK THE BOOTLOADER with Volume + and valid with Power.

    • On previous version of fastboot, the last command is fastboot oem lock

  3. Enjoy! The device will now reboot automatically on /e/.

Getting a fastboot error ?

  • On some versions of fastboot you may get an error while running the Fastboot flash boot boot.img command

  • The below error may show up on the console

      fastboot error: couldn’t parse partition size ‘0x’
    
  • A workaround for this error is as under. Run this command on the console:

      fastboot getvar current-slot
    
  • This would show the current active slot. For e.g. if it shows a , run the below command

      fastboot --set-active=b
      fastboot flash boot_b boot.img
    
Tip: If you find an issue with this installation document or if you want to suggest improvements, Please create a dedicated thread on our community forum
Success: Congratulations !! Your phone should now be booting into /e/OS !!
To find some troubleshooting tips… click here

adb

  • Getting a Total xFer ':' 0.01x message - Try to upload the /e/OS to internal storage and retry to install
  • adb ':' sideload connection failed ':' insufficient permissions for device error - Try to execute the commands adb kill-server and adb start-server and retry
  • Running adb shell twrp install /sdcard/</e/ zip package> raise non-existent directory error - Try to check solution here
  • Getting an insufficient permissions error - Try the solution given here
  • When running "adb devices" in bash a device is shown as "unauthorized" - Try the solution given here

TWRP

  • Errors while running TWRP version 3.4.x.x or above - Try downloading and using a previous TWRP version.. below 3.4.x.x
  • In TWRP if this error shows up failed to mount /preload - Try in TWRP wipe screen in advanced menu select preload and swipe to wipe
  • /cache/recovery/xxx -> no such file or directory error while flashing a ROM - On PC run adb shell in the console now create a folder called recovery for e.g. here the devicecode name is violet "violet :/cache# mkdir recovery"



Still need help to complete the installation ?

Check out this document: An [install Guide]([HOW-TO] Flash /e/-OS on Fairphone 3 using Debian based GNU/Linux) for the FP3

Tip: If you need help following this procedure or want to discuss any modification to it, please visit our dedicated topic on our community forum