[HOWTO] a Clear Guide to install "IMG-e-builds" when /e/ web installer fails

.

in 3 copy / paste actions !

.

because even well illustrated, the “web-installer” often don’t work,

and because the official documentation is imbuvable for some new users.

.

.

here we take the Fairphone 6 as example,
but it is the same logical and quite the same process for all the devices that have :

  • only "IMG-e-xxxxxxxxxxx.zip" file on their download page,
  • no "recovery-e-xxxxxxxxxx.img" file on their download page,
  • no "recovery-IMG-e-xxxxxxxxxx.zip" file on their download page,
  • that contains an install script named like flash_FP6_factory.sh.

.
(non exhautive device list)
Fairphone : FP3, FP4, FP5, FP6,
Gigaset : GS290,
Murena : one, two,
Nothing : tetris,
OnePlus : avicii,
Google : panther,
Shift : axolotl, otter,
Teracube : sapphire,
Volla : mimir,
.

for other devices that have
"recovery-e-xxxxxxxxxx.img" or "recovery-IMG-e-xxxxxxxxxx.zip" file
on their download page, use this : [HOWTO] an Unified Install Guide Project for /e/

.

.

.




.

Windows Guide :

.

Expand

.

according to Install /e/OS on a Fairphone The Fairphone (Gen. 6) - “FP6”

If you plan to relock the bootloader after the installlation

this is not mandatoty, and only available with Official version, why relocking ?

Most important thing to take care about is the “android Security Update" aka "Security Patch Level” date (SPL) included in the already installed Operating System on your device at time of the unlock.

It must be OLDER than the “android Security Update" aka "Security Patch Level” date (SPL) included in the /e/OS build you want to install, otherwise you risk to change your device into Brick.

  • You will find this information about stock OS on the device :

settings --> about phone --> android version 15 --> android security update

  • you will find this information about /e/OS build on the install instructions page for you device if your device is supported by /e/

  • but also on the release article about the /e/OS version you want to install :
    the title of the article need to match both “/e/OS version” and “android level”,
    currently "e-3.2-a15"

Releases · e / os / :rocket: Releases · GitLab


more detailled explications here : (answered) Install /e/ on FP5 with newer Security Patches

.




.

other things you must take care about

Your Stock OS Android version, must be the latest available relative to the /e/OS build you want to install → not higher !

Remove all Gogol accounts, screen lock or SIM lock from the device.

Use a USB-A to USB-C cable on a rear USB port (no hub even internal if possible)

.



.

Unlocking the bootloader

.

the “Unlocking the bootloader” step may differ, so to be safe, allways have a read on

Smartphone Selector” → “Official or Community install doc” for your device → “Command line” install page for your device !

in case of Fairphone devices, get the Unlock code from Fairphone before proceeding with the next steps

.

on your device, enable USB debugging and allow OEM unlocking .

  • Reboot the device to bootloader mode with the command adb reboot bootloader,
    or with the device powered off - hold Volume Down + Power

On your PC, install Git-bash, and confirm all preselected options.

download the “platform-tools for windows”, and just extract the .ZIP, not more.

open the newly created “platform-tools” folder in your file manager, then

  • use the right clic of your mouse, and choose open Git Bash here.

you will get something like :

  • Ask for unlock by copy this command and paste it in the terminal :
.\fastboot flashing unlock
  • Approve with volume + then power

The device proceed with a factory reset, and automatically reboots

on your device, re-enable USB debugging and re-allow OEM unlocking .
and reboot again into bootloader

  • Unlock critical by copy this command and paste it in the terminal :
.\fastboot flashing unlock_critical
  • Approve with volume + then power

The device proceeds with a factory reset, and automatically reboots

the Bootloader is now unlocked

.




.

Installing /e/OS

.

on your device, re-enable USB debugging and allow OEM unlocking .
Again reboot the device into bootloader mode.

on your PC, take latest /e/OS official FP6 download and just extract it, not more.

From the newly created folder /IMG-e-3.2-a15-20251022539003-official-FP6,

  • right clic with your mouse, and choose open Git Bash here.

  • copy this command and paste it in the git-bash terminal :
    (replace “FP6” by your device codename)

chmod +x flash_FP6_factory.sh && ./flash_FP6_factory.sh

you will get something like :

you are done with installing /e/OS

now, if you don’t want to relock the bootloader, just run :

./fastboot reboot

if you want to relock the bootloader, continue with next step.

.

.




.

Finaly,

only if the android security update in the previously installed Stock OS was older
than the android security update included in the /e/ build you want to install
you will be able to relock the bootloader according to instructions at the bottom of the device install page (only possible with Official version)

Don’t boot /e/OS after installing and before relocking the bootloader !

with the device in bootloader mode, Open a terminal from the “/platform-tools” location
and check bootloader status by running :

./fastboot oem device-info
./fastboot flashing get_unlock_ability

if the return is 1
→ you can relock now, and you will be able to unlock again in the future

if the return is 0
→ you can relock now, but you may not be able to unlock again in the future
IT IS ADVISED to not relock now, but to reinstall FairphoneOS boot on it (to get =1), and then reinstall /e/OS.

to relock the bootloader, copy / paste this command :

./fastboot flashing lock_critical
  • Approve with volume + then power
  • but then if the device try to reboot, press and hold down the volume down button and the power button for the phone comes to fastboot mode without starting the operating system !
  • and copy / paste this command :
./fastboot flashing lock
  • Approve with volume + then power
  • the device must reboot, if not, copy / paste this command
./fastboot reboot

.

What could go wrong

[Solved] Windows does not see my phone in Fastboot mode because needed drivers are not correctly installed

Tip :

if not properly "installed in your path” as explained in Installing adb and fastboot on Windows PC ,
simply add ./ at the beginning of all your adb or fastboot commands,
it will use the version included into the relative folder (the latest) instead of the one installed on your system (that can be outdated)

.

.




.

Linux Guide :

.

Expand

.

according to Install /e/OS on a Fairphone The Fairphone (Gen. 6) - “FP6”

If you plan to relock the bootloader after the installlation

this is not mandatoty, and only available with Official version, why relocking ?

Most important thing to take care about is the “android Security Update" aka "Security Patch Level” date (SPL) included in the already installed Operating System on your device at time of the unlock.

It must be OLDER than the “android Security Update" aka "Security Patch Level” date (SPL) included in the /e/OS build you want to install, otherwise you risk to change your device into Brick.

  • You will find this information about stock OS on the device :

settings --> about phone --> android version 15 --> android security update

  • you will find this information about /e/OS build on the install instructions page for you device if your device is supported by /e/

  • but also on the release article about the /e/OS version you want to install :
    the title of the article need to match both “/e/OS version” and “android level”,
    currently "e-3.2-a15"

Releases · e / os / :rocket: Releases · GitLab


more detailled explications here : (answered) Install /e/ on FP5 with newer Security Patches

.



.

other things you must take care about

Your Stock OS Android version, must be the latest available relative to the /e/OS build you want to install → not higher !

Remove all Gogol accounts, screen lock or SIM lock from the device.

Use a USB-A to USB-C cable on a rear USB port (no hub even internal if possible)

.




.

Unlocking the bootloader

.

the “Unlocking the bootloader” step may differ, so to be safe, allways have a read on

Smartphone Selector” → “Official or Community install doc” for your device → “Command line” install page for your device !

in case of Fairphone devices, get the Unlock code from Fairphone before proceeding with the next steps

.

on your device, enable USB debugging and allow OEM unlocking .

  • Reboot the device to bootloader mode with the command ./adb reboot bootloader,
    or with the device powered off - hold Volume Down + Power

On your PC, download the “platform-tools for Linux”, and just extract the .ZIP, not more.

open the newly created “platform-tools” folder in your file manager,

  • use the right clic of your mouse, and choose open in a terminal.

you will get something like :

  • Ask for unlock by copy this command and paste it in the terminal :
./fastboot flashing unlock
  • Approve with volume + then power

The device proceed with a factory reset, and automatically reboots

Reboot again into bootloader

  • Unlock critical by copy this command and paste it in the terminal :
./fastboot flashing unlock_critical
  • Approve with volume + then power

The device proceeds with a factory reset, and automatically reboots

the Bootloader is now unlocked

.




.

Installing /e/OS

.

Again reboot the device into bootloader mode.

on your PC, take latest /e/OS official FP6 download and just extract it, not more.

From the newly created folder /IMG-e-3.2-a15-20251022539003-official-FP6,

  • right clic with your mouse, and choose open in a terminal.
  • copy this command and paste it in the terminal :
    (replace “FP6” by your device codename)
chmod +x flash_FP6_factory.sh && ./flash_FP6_factory.sh

you will get something like :

you are done with installing /e/OS

now, if you don’t want to relock the bootloader, just run :

./fastboot reboot

if you want to relock the bootloader, continue with next step.
.

.




.

Finaly,

only if the android security update in the previously installed Stock OS was older
than the android security update included in the /e/ build you want to install
you will be able to relock the bootloader according to instructions at the bottom of the device install page (only possible with Official version)

Don’t boot /e/OS after installing and before relocking the bootloader !

with the device in bootloader mode, Open a terminal from the “/platform-tools” location
and check bootloader status by running :

./fastboot oem device-info
./fastboot flashing get_unlock_ability

if the return is 1
→ you can relock now, and you will be able to unlock again in the future

if the return is 0
→ you can relock now, but you may not be able to unlock again in the future
IT IS ADVISED to not relock now, but to reinstall FairphoneOS boot on it (to get =1), and then reinstall /e/OS.

to relock the bootloader, copy / paste this command :

./fastboot flashing lock_critical
  • Approve with volume + then power
  • but then if the device try to reboot, press and hold down the volume down button and the power button for the phone comes to fastboot mode without starting the operating system !
  • and copy / paste this command :
./fastboot flashing lock
  • Approve with volume + then power
  • the device must reboot, if not, copy / paste this command
./fastboot reboot

.

Tip :

if not properly "installed in your path” as explained in Installing adb and fastboot on Linux PC ,
simply add ./ at the beginning of all your adb or fastboot commands,
it will use the version included into the relative folder (the latest) instead of the one installed on your system (that can be outdated)

.




.

macOS Guide :

.

Expand

.

according to Install /e/OS on a Fairphone The Fairphone (Gen. 6) - “FP6”

If you plan to relock the bootloader after the installlation

this is not mandatoty, and only available with Official version, why relocking ?

Most important thing to take care about is the “android Security Update" aka "Security Patch Level” date (SPL) included in the already installed Operating System on your device at time of the unlock.

It must be OLDER than the “android Security Update" aka "Security Patch Level” date (SPL) included in the /e/OS build you want to install, otherwise you risk to change your device into Brick.

  • You will find this information about stock OS on the device :

settings --> about phone --> android version 15 --> android security update

  • you will find this information about /e/OS build on the install instructions page for you device if your device is supported by /e/

  • but also on the release article about the /e/OS version you want to install :
    the title of the article need to match both “/e/OS version” and “android level”,
    currently "e-3.2-a15"

Releases · e / os / :rocket: Releases · GitLab


more detailled explications here : (answered) Install /e/ on FP5 with newer Security Patches

.



.

other things you must take care about

Your Stock OS Android version, must be the latest available relative to the /e/OS build you want to install → not higher !

Remove all Gogol accounts, screen lock or SIM lock from the device.

Use a USB-A to USB-C cable on a rear USB port (no hub even internal if possible)

.




.

Unlocking the bootloader

.

the “Unlocking the bootloader” step may differ on some devices, so to be safe, allways have a read on

Smartphone Selector” → “Official or Community install doc” for your device → “Command line” install page for your device !

in case of Fairphone devices, get the Unlock code from Fairphone before proceeding with the next steps

.

on your device, enable USB debugging and allow OEM unlocking .

  • Boot the device to bootloader mode with the command ./adb reboot bootloader,
    or with the device powered off - hold Volume Down + Power

on your macOS,
download the latest /e/OS build from Smartphone Selector,
then extract the.ZIP, and rename the newly created folder
“IMG-e-3.2-a15-2025xxxxxxxxxx-xxxxxxxxx-xxxxxxxx” into "IMG-e".

open the macos terminal from “Applications” → utilities → terminal.
you will see something like :

  • Ask for unlock the bootloader by copy this command and paste it in the terminal :
~/Downloads/IMG-e/bin-darwin/./fastboot flashing unlock
  • Approve with volume + then power

The device proceed with a factory reset, and automatically reboots

Reboot again into bootloader

  • Unlock critical partitions by copy this command and paste it in the terminal :
~/Downloads/IMG-e/bin-darwin/./fastboot flashing unlock_critical
  • Approve with volume + then power

The device proceeds with a factory reset, and automatically reboots

the Bootloader is now unlocked

.




.

Installing /e/OS

.

Again reboot the device into bootloader mode.

.

On your computer,

  • copy this command and paste it in the terminal to go into the folder that contain the files :
cd  ~/Downloads/IMG-e/
  • copy this command and paste it in the terminal to make the script executable :
    (replace “FP6” by your device codename)
chmod +x flash_FP6_factory.sh
  • copy this command and paste it in the terminal to execute the script :
    (replace “FP6” by your device codename)
./flash_FP6_factory.sh

you will get something like :

you are done with installing /e/OS

now, if you don’t want to relock the bootloader, just run :

~/Downloads/IMG-e/bin-darwin/./fastboot reboot

if you want to relock the bootloader, continue with next step.

.

.




.

Finaly,

only if the android security update in the previously installed Stock OS was older
than the android security update included in the /e/ build you want to install
you will be able to relock the bootloader according to instructions at the bottom of the device install page (only possible with Official version)

Don’t boot /e/OS after installing and before relocking the bootloader !

with the device in bootloader mode,
check bootloader status by running :

~/Downloads/IMG-e/bin-darwin/./fastboot oem device-info
~/Downloads/IMG-e/bin-darwin/./fastboot flashing get_unlock_ability

if the return is 1
→ you can relock now, and you will be able to unlock again in the future

if the return is 0
→ you can relock now, but you may not be able to unlock again in the future
IT IS ADVISED to not relock now, but to reinstall FairphoneOS boot on it (to get =1), and then reinstall /e/OS.

to relock the bootloader, copy / paste this command :

~/Downloads/IMG-e/bin-darwin/./fastboot flashing lock_critical
  • Approve with volume + then power
  • but then if the device try to reboot, press and hold down the volume down button and the power button for the phone comes to fastboot mode without starting the operating system !
  • and copy / paste this command :
~/Downloads/IMG-e/bin-darwin/./fastboot flashing lock
  • Approve with volume + then power
  • the device must reboot, if not, copy / paste this command
~/Downloads/IMG-e/bin-darwin/./fastboot reboot

.

Tip :

if not properly "installed in your path” as explained in Installing adb and fastboot on Linux PC ,
simply add ./ at the beginning of all your adb or fastboot commands,
it will use the version included into the relative folder (the latest) instead of the one installed on your system (that can be outdated)

.




.

Feel free to ask if you still encountred issue.

.

you may also be interrested by :
[HOWTO] Upgrade my /e/OS to major Android version without loosing /data

.

4 Likes
/e/OS Installer unable to install /e/OS on Fairphone 4
Stuck in step 7: Fairphone 6 connects to browser but does not show up in phone
Trouble installing e/os on FP6 using the web installer on Linux
Fairphone /e/os Factory Install guide
Eos installer: Device (FP6) is found but doesn't upload
FP4 - kein fastboot kein sideload mehr möglich, e startet nicht mehr
Unable to install eOS on fairphone 6
FP6 stuck in bootloader after install
New FP6 installing e/OS using Mac
Code / fingerprint locked after manually install e os on fp6
Problem on Fairphone 5 - cannot setup password/pin/pattern
/e/ OS installation on CMF nothing phone is stuck
Is it safe to lock my FP6 bootloader?
Can´t install FP6 with installer
Can´t install FP6 with installer
Impossible d'installer e os sur un fairphone 5 ou 6
Easy installer pixel 7 gros souci
Android update slow and stops very often
Week 48, 2025: Development and Testing Updates
/e/ os installer sur Fairphone4 impossible
[HOWTO] an Unified Install Guide Project for /e/
Easy installer pixel 7 gros souci
Pixel 7 Stuck on Step 16/21
Factory Reset during bootloader unlocking
Can't unlock critical partitions
22. November :spiral_calendar: Aachener Fairphone-Stammtisch | Meet Fairphone 6
Eos installer: Device (FP6) is found but doesn't upload
Fairphone 6 - Corrupt device after locking the bootloader
[/e/OS installer on Fairphone 6] "Allow USB debugging?" popup doesn't appear
Pixel 7 official install re lock
FP 6 Installation & Bootloader
e/OS FP6 install stuck on step 22 - any advice?
/e/os auf CMF Phone 1 installieren, bin verwirrt
Is it safe to lock my FP6 bootloader?
Fp6 fingerprint or code not working
Fairphone - FP6 - FP6 - Documentation Suggestions
Sdkmanager / adb install via Raspberry Pi OS?
Installing e/OS on CMF Nothing Phone 1 - A15
Easy installer pixel 7 gros souci
Proplem mit e.os Installation auf fairphone4
Fp6 fingerprint or code not working
Fairphone - FP6 - FP6 - Documentation Suggestions
Fairphone 6: unable to boot into bootloader mode
[HOWTO] Upgrade my /e/OS to major Android version without loosing /data
Mise a jour impossible sur FP5
Web installer seemed to brick my Fairphone 5
Eos installer: Device (FP6) is found but doesn't upload
Samsung S7 : SIM Card disables after seconds
Eos installer: Device (FP6) is found but doesn't upload
Fairphone - FP4 - FP4 - Documentation Suggestions
Web installer seemed to brick my Fairphone 5
Installation of e/OS on CMF Phone 1
Help! Disconnected while Flashing, now stucked at Bootloader
Help! Disconnected while Flashing, now stucked at Bootloader
Fp6: not booting
/e/os Installation on Nothing Phone 1 takes ages
[TUTO] INSTALLER MANUELLEMENT /e/OS VERSION OFFICIAL SUR UN FAIRPHONE FP4 FP5 FP6
FP6 - reverrouiller le bootloader - question
Installation of e/OS on CMF Phone 1
Installation of e/OS on CMF Phone 1
Fairphone 6 stuck in Fastboot Mode after locking with /e/OS/ installer
Mise a jour impossible sur FP5
Week 50, 2025: Development and Testing Updates
Installing E/OS on Fairphone 4 fails: doesnt find device
Fairphone 6 stuck in Fastboot Mode after locking with /e/OS/ installer
e/OS/ install gets stuck in bootloader
Installing E/OS on Fairphone 4 fails: doesnt find device
FP3-update impossible
FP5 e/OS installer doen't progress at bootloader stage
Fairphone 6 stuck in bootloader after install e/os
Fairphone 6 stuck in bootloader after install e/os
Problem bei der Installation
Unable to set password, attach files to text messages, or edit photos
More De-Googling?
[HELP] I cannot manage to install e/os in my android FP6
FP6, Trying To Install /e/os But Failed Again
[HELP] I cannot manage to install e/os in my android FP6
[HELP] I cannot manage to install e/os in my android FP6
Pixel 7 Fail to use Installer
Adb not included in build zip
Murena for phones under Android... Which solution for PCs under Windows?
/e/ OS installation on CMF nothing phone is stuck
FairPhone 5 hat kein OS mehr / es wird nur noch Bootload -START angezeigt
Fairphone - FP6 - FP6 - Documentation Suggestions
Installation of e/OS on CMF Phone 1
Installation of e/OS on CMF Phone 1
Fairphone 6 Error on step: connect-bootioader
Installation of e/OS on CMF Phone 1
Eos installer: Device (FP6) is found but doesn't upload
Web installer: which version will it install?
Unable to install eOS on fairphone 6
Fairphone 6 flash_FP6_factory.sh seems to hang
Fairphone 6 stuck in bootloader after install e/os
Fairphone 6 stuck in bootloader after install e/os
Fairphone 3 et avenir
Fairphone 5 wont boot after eOS installer
Can't enable OEM unlocking after relocking the bootloader
Fairphone 5 Bootloader locked and corrupted after A15 e/os official install despite the latest security patch
List of HOWTOs & add your suggestions
Fairphone 6 stuck in bootloader after install e/os
Fairphone 4 - switch from android to e/os
Fairphone 6 stuck in bootloader after install e/os
Installation /e/OS sur FP6 : impossible ni via web-intaller, ni via commandes manuelles

Hi

The installation script won’t run for me. It claims I have critical partitions locked which might be true. I’m on LineageOS 23 and Fairphone 4 and already have an unlocked bootloader.

I booted to the bootloader (“adb reboot bootloader”) and ran the script. I tried “fastboot flashing unlock” and “fastboot flashing unlock_critical”.

Do I need to maybe revert back to the FairphoneOS and relock and then unlock the bootloader? Sounds risky…:thinking:

Please check the “android security update” of your LOS 23, it must be older than 2025.10.01

1 Like

Oh okay. I guess I’ll have to wait a while and try again. Thanks!

Hello!

Thank you very much for this detailed guide! I was stuck with the web installer.

I managed to complete all the first steps, but I can’t unlock the critical partitions… I managed to unlock eom, and the phone displays “device state - unlocked,” but when I try the fastboot flashing unlock_critical command, I get the following error message:

FAILED (remote: ‘Flashing Unlock is not allowed’)
fastboot: error: Command failed

Do you have any idea what might be blocking it?

I have a FP6 running Android Google, security patch 2025-11-05 (the official install doc says 2025-12-05), and I’m using an Acer laptop running Windows 10.

Thank you very much for your help!

Hello @edberger, Welcome to the /e/ users forum.

be carefull !

this is a typo !

image

→ 2025.12.01 is related to e-3.3 (not yet released at time i write),

and not to e-3.2 (that have 2025.10.01 SPL) you are currently trying to install

image

what are the output for :

1 Like

Ohh, thanks for the warning, I didn’t pay attention. I understand that I will need to download 3.3 version if I want to relock it and not brick. (I didn’t download anything for the moment)

For fastboot oem device-info, the output is:

(bootloader) Verity mode: true
(bootloader) Device unlocked: true
(bootloader) Device critical unlocked: false
(bootloader) Charger screen enabled: true

and for fastboot flashing get_unlock_ability, it is:

(bootloader) get_unlock_ability: 0

And USB debugging is still allowed, screen unlocked, no SIM, adb and fastboot tools are updated…

flashing the FairphoneOS again should switch the ability to 1
when flashing e-3.3 (or any custom OS) is not expected to do that.

DO NOT RELOCK.

so my advise (to stay on the safe side) is to reinstall FairphoneOS, and re run

./fastboot oem device-info
./fastboot flashing get_unlock_ability

before and after installing /e/

okay, I tried flashing FairphoneOS via your link, I downloaded the latest Android version, SPL matches, and have the same error message about the critical partitions when installing the software…

ERROR: The critical partitions are not unlocked.
Please refer to our support articles for help.
ERROR: Aborting now (press Enter to terminate).

And Fairphone support doesn’t mention this point…

Unlock ability is still 0

However, I can still start the phone without any problems. FairphoneOS is still installed, it just warns me that the bootloader is unlocked at startup.

you are right, but i found

Hi there,

I just reset my phone to install eos just to find out that the official build is in fact not out yet.
Is there any information as to when it will be released?

Can i just install the community version now and upgrade when the official version launches?

Thanks in advance

For clarity, this is the initial sequence, following the application of the Fairphone code.

  1. Ask for unlock with fastboot flashing unlock
  2. Approve with volume + then power
  • The device proceed with a factory reset, and automatically reboots
  1. Reboot again into bootloader
  2. Unlock critical with fastboot flashing unlock_critical

Did every prior step happen just as described including the factory reset?

This announcement indicates a delay till after the weekend. Feedback for v3.3 - #124.

You cannot just change community to official without factory reset … but you can install community, play with it, install official after release with Factory reset.

Okay I understand better now… Thank you for the research.

I think the device rebooted twice before I could try to unlock the critical partitions, so get_unlock_ability was already reset to 0 before I ran the command. And the OEM unlock button is grayed out now.

I understand that I’m stuck. Should I contact FP support for help, or is it a bad idea?

Yes, steps 1, 2, and 3 worked, the phone rebooted with a factory reset.

However, I turned it off and then on again to start it in fastboot mode, I didn’t do it immediately after the first boot. And after that, step 4 didn’t work, because I should have done it immediately after the first boot, from what I understand above.

Is it possible that a google account was still connected with the Stock FairphoneOS ?

No I never connected any Google account on the phone…

1 Like

e-3.3 have been released now, does it helps ?

Also there is this experience :