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

.

.

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

and because the install instructions provided by /e/ can be imbuvable for some new users and can lead to errors.

here is a safe guide to install /e/OS

.

.

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/

.




.

Expand to see the guide :

.

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

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 ! (this don’t apply to Fairphone devices)

Warning: Before proceeding with the installation, log out of any accounts you may have set on the stock ROM. Also, remove any screen locks that have been set on the device.

Use a USB-A to USB-C cable on a rear USB port if possible, to avoid hub even internal

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 installed Operating System on your device at time of the unlock.

new version on witch you want to relock the bootloader, must included a NEWER (or the same) “android Security Update" aka "Security Patch Level” date (SPL),

otherwise you risk to change your device into Brick.

  • You will find this information about stock OS

on the Fairphone website The Fairphone Release Notes

or on the device :

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

  • you will find this information about /e/OS

on the /e/OS website / e / os :rocket: Releases

(the title of the article need to match both “/e/OS version” and “android level”)

here "e-3.2-a15"

or on the device :

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

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

.




.

1. Unlocking the bootloader

(this will erase personnal datas on the device)
.

The “Unlocking the bootloader” step may differ from device to an other, 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 Developer Options, USB debugging and allow OEM unlocking .

you will be asked for the code.

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

.

On your Computer :

.

Expand if you use Windows :

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
    (it is the same as "open a terminal in this folder").

you will get something like :

.

Expand if you use Linux :

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

  • Use the right clic of your mouse, and choose "open a terminal in this folder").

you will get something like :

.

Expand if you use macOS :

open the macos terminal from “Applications” → utilities → terminal.

cd ~/Downloads/platform-tools

(it is the same as “open a terminal in this folder”)
you will get something like :

.

  • Check bootloader status by copy this command, paste it into the terminal and press enter :
./fastboot oem device-info
./fastboot flashing get_unlock_ability

if the return is 1

→ you will be able to unlock

if the return is 0

→ you will not be able to unlock now, it is advised to

  • Ask for unlock bootloader by running :

./fastboot flashing unlock

  • Approve with volume + then power

Your device proceed with a factory reset, and automatically reboots

On your device, re-enable Developer Options, USB debugging and allow OEM unlocking .

and reboot again into bootloader

  • check bootloader status

./fastboot flashing get_unlock_ability

if the return is 1

→ you will be able to unlock

if the return is 0

→ you will not be able to unlock now, it is advised to

  • Ask to unlock critical partitions by running

./fastboot flashing unlock_critical

  • Approve with volume + then power

Your device proceeds with a factory reset, and automatically reboots

the Bootloader is now unlocked

.




.

2. Installing /e/OS

.

On the device, re-enable Developer Options, USB debugging and allow OEM unlocking .

Again reboot the device into bootloader mode.

On the PC, download latest build from /e/OS website,

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

in case here : /e/OS official FP6 download,

just extract it, not more.

.

Expand if you use Windows :

Use the right clic of the mouse, and choose

open Git Bash here

.

Expand if you use Linux :

Use the right clic of the mouse, and choose

open a terminal in this folder

.

Expand if you use macOS :

in Finder, rename the newly extracted folder

IMG-e-3.2-a15-20251022539003-official-FP6 into IMG-e,

and in the terminal, copy / paste

cd ~/Downloads/IMG-e

.

  • Copy this command and paste it into the terminal :

(replace “FP6” by your device codename)


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

you are done with installing /e/OS

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

just run :


./fastboot reboot

But if you want to relock the bootloader,

continue with next step.

.




.

3. Finaly, relock the bootloader (optional)

only how it is mentionned at the bottom of the official instructions in the “Smartphone Selector” for your device → “Official or Community install doc” for your device → “Command line” install page for your device !

only if the android security update in the previously installed OS was

older than the android security update included in the version you want to install

only if the newly installed version is an Official one, not a Community version.

re-enable Developer Options, USB debugging and allow OEM unlocking

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 will be able to relock

if the return is 0

→ locking should be feasible, BUT you will not be able to unlock again in the future…
→ it is advised to

  • to relock critical partitions, copy / paste this command :

./fastboot flashing lock_critical

  • Approve with volume + then power
    then
  • Hold the Volume Down button immediately as your Fairphone reboots to return to fastboot mode.

otherwise the device will try to reboot into system,

if so : re-enable Developer Options, USB debugging and allow OEM unlocking if needed,

re-run


fastboot flashing get_unlock_ability

if the return is 1
→ you will be able to relock

if the return is 0
→ locking should be feasible, BUT you will not be able to unlock again in the future…
→ it is advised to

  • to relock the bootloader, copy / paste this command :

./fastboot flashing lock

  • Approve with volume + then power

the device must reboot, if not, copy / paste this command


./fastboot reboot

boot to the system,

and disable “allow OEM unlocking”, “USB debugging”, and “Developer Options”

the bootloader is now relocked.

.




.

What could go wrong :

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

Tip :

if not properly "installed in your path” as explained
in Installing adb and fastboot on Windows PC,
or in Installing adb and fastboot on macOS and Linux PC,

simply add ./ at the beginning of all your adb or fastboot commands, will use the binary included into the relative folder (the latest you downloaded) instead of the version installed on your system (that can be outdated)

.

.




.

Feel free to ask if you still encountred issue.

or want i made some corrections / additions

.

you may also be interrested by :

[HOWTO] Upgrade my /e/OS to major Android version without loosing /data

.

7 Likes
Fairphone 6 stuck in bootloader after install e/os
/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
Installation on brand new Pixel8
Can't activate any screen lock
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
Nothing phone cmf 1
Fairphone 4 - switch from android to e/os
Fairphone 6 stuck in bootloader after install e/os
Git Bash yes or no in installation instructions for FP4
Locking the Bootloader will factory reset your device according to installation instructions for FP4?
Install e/Os on Pixel 7: Problems with sideload e/Os
Installation e/OS Fairphone 3
Installation /e/OS sur FP6 : impossible ni via web-intaller, ni via commandes manuelles
Eos installer: Device (FP6) is found but doesn't upload
Fairphone 5: the web installer failed, now about to try the manual installation but one question remains
Fairphone 5: the web installer failed, now about to try the manual installation but one question remains
What does 'brick' mean in FP4 installation instructions?
Fairphone 5: the web installer failed, now about to try the manual installation but one question remains
Locked out - how to rest/-install?
FP4 - kein fastboot kein sideload mehr möglich, e startet nicht mehr
Fairphone 6 Reinstalling Stock Android
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
Fairphone 4 lock Bootloader after Web Installer
Install e/Os on Pixel 7: Problems with sideload e/Os
Problem on Fairphone 5 - cannot setup password/pin/pattern
/e/ OS installation on CMF nothing phone is stuck
Can't install e/os on new FP5 via ubuntu
Is it safe to lock my FP6 bootloader?
Fairphone6 stuck on Murena logo after flashing to : IMG-e-3.5-a15-20260211580868-official-FP6.zip
Install e/OS A14 on Fairphone 4 with A15 ? anti-rollback problems?
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
Unable to share links from apps or browser
Web installer can't find and connect with Fairphone 5 after reboot step
Can´t install FP6 with installer
/e/ os installer sur Fairphone4 impossible
[HOWTO] an Unified Install Guide Project for /e/
Problème lors installation eos sur fairphone 6 avec un mac opera /e/OS Installer
Easy installer pixel 7 gros souci
Stuck with webinstaller FP5
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?
Help: bootloop CMF Phone 1
Strange installation and upgrade behaviour Pixel 7
Probleme bei Installation auf FP6
/e/os auf CMF Phone 1 installieren, bin verwirrt
e/Os Installation Fairphone 6
Fairphone 6 boot loader not locked
Is it safe to lock my FP6 bootloader?
Can´t install FP6 with installer
Fp6 fingerprint or code not working
Fairphone - FP6 - FP6 - Documentation Suggestions
Finished my /e/OS install. An amateurs feedback
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
Adb not included in build zip
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
Processus d'installation bloqué : Connexion au bootloader
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
Code / fingerprint locked after manually install e os on fp6
Phone not recognized in bootloader
Just got my new fairphone 6 with /e/OS and it's working fine :)
Installation e/OS/ sur Fairphone 4 via iMac
Installing /e/OS on a Fairphone 6 that is pre installed with Android
Installing E/OS on FP6 with Web Installer Fails “Error on step: connect-bootloader 22/24
Installing /e/OS on a Fairphone 6 that is pre installed with Android
Installation problem with E/OS on Volla tablet
Locking the bootloader on my FP6 from a mac
FP5 e/OS installer doen't progress at bootloader stage
Prevent brick fp5 eOS setup, instructions unclear
Display Lock is not possible
Firefox and e/OS
Display Lock is not possible
Installation problem with E/OS on Volla tablet
Device corrupt - locked boot loader = bricked device? FP6
Fairphone6 stuck on Murena logo after flashing to : IMG-e-3.5-a15-20260211580868-official-FP6.zip
Can't install e/os on new FP5 via ubuntu
My fairphone 6 is after installing e os in a bootloop
Fairphone 6 in fastboot reboot loop after web installer
Web installer can't find and connect with Fairphone 5 after reboot step
Web installer can't find and connect with Fairphone 5 after reboot step
Finished my /e/OS install. An amateurs feedback
FP6 After eOS 3.6 to Android A16 Rollback stuck in Bootloader
OEM-Entsperrung lässt sich nicht aktivieren!
Hi i'm new and which android to /e/OS version i need?
Murena for phones under Android... Which solution for PCs under Windows?
/e/ OS installation on CMF nothing phone is stuck
Web installer for FP4 seems to unlock bootloader twice
FairPhone 5 hat kein OS mehr / es wird nur noch Bootload -START angezeigt
OnePlus Nord installation stuck in fastbootd when running install script
Fairphone - FP6 - FP6 - Documentation Suggestions
What is "verify if the latest Android firmware is available for your device"?
Where to find security patch levels to avoid to brick phone
Fairphone 6 /e/ setup after web installer
Installation of e/OS on CMF Phone 1
Installation of e/OS on CMF Phone 1
E/os fairphone fp5 screen locking failure
Troubles when installing /e/os on Fairphone 6 via Webinstaller
Fairphone 6 Error on step: connect-bootioader
Installation of e/OS on CMF Phone 1
Can't unlock critical partitions
Eos installer: Device (FP6) is found but doesn't upload
Web installer: which version will it install?
Unable to install eOS on fairphone 6
FP3 still on community A13 (3.0.4). Update now? How?
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
Pixel 8 flashing process - looking for advice
Help; Can't seem to unlock bootloader, difficulty with installation
Can't unlock critical partitions
Fairphone 3 et avenir

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

2 Likes

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

1 Like

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 :

2 Likes

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/

1 Like

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

1 Like

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?

2 Likes

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.

1 Like

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 :

1 Like

There is something i do not understand in this guide.
It asking to delete all Google account, remove Screenlock and Pin.
But when you unlock the bootloader will do factory reset.
In my opinion this will erase the Google accounts, locks and PINS (In my case SIM-Related)

These locks are registred outside the /data partition…
(FRP means Factory Reset Protection)

3 Likes

Sorry, but I don’t understand it anymore.
The phone keeps rebooting, and I can start it in either bootloader mode or recovery, where I can choose fastboot mode under advanced settings.
I don’t understand how to revert it to Android or how to install eOS on it. I’ve asked if anyone can help me with this because it’s not going to work this way. Apparently, I shouldn’t have tried this and was too excited about returning to eOS.