Howto troubleshoot issues with the easy-installer

General hints

Please specify operating system and phone model

In case you ask for help, please specify which operating system you are using and whether you try to install on FP3 or FP3+. If it’s an FP3, please also specify if you’ve done the update to Android 10 or if you’re still on Android 9.

Where to find the log

The installer creates a log file with a randomly generated name (e.g. 45761d08-711f-435a-881d-a236949654bb.log) that might contain useful information if something doesn’t work as expected.

Location of the log file:

  • Linux: ~/snap/easy-installer/common
  • Windows: %LOCALAPPDATA%\easy-installer

The log file is too large to upload to the forum directly. If you report a problem, please paste the contents of the logfile to https://haste.tchncs.de/ and click the save icon there which will generate a link which you can then use here.

If the log is too large even for haste and you already have an /e/ account, you can ZIP the log and upload it to your /e/ account cloud storage.

Problems running the installer

If the installer just doesn’t start as if nothing happens (on Linux)

If you click on the easy-installer icon and nothing happens at all, please open a terminal and execute

snap run easy-installer

This will likely generate some error output you can check against the known issues below.

Unable to open DISPLAY (on Linux)

This happens when the installer is run on wayland. It should work in an xorg session. See: Running Easy Installer on Linux

To check what kind of session you are running, execute the following in a terminal: loginctl show-session ID -p Type

The full error looks like this:

    Exception in thread "main" java.lang.reflect.InvocationTargetException
	at java.base/jdk.internal.reflect.NativeMethodAccessorImpl.invoke0(Native Method)
	at java.base/jdk.internal.reflect.NativeMethodAccessorImpl.invoke(Unknown Source)
	at java.base/jdk.internal.reflect.DelegatingMethodAccessorImpl.invoke(Unknown Source)
	at java.base/java.lang.reflect.Method.invoke(Unknown Source)
	at java.base/sun.launcher.LauncherHelper$FXHelper.main(Unknown Source)
Caused by: java.lang.UnsupportedOperationException: Unable to open DISPLAY
	at javafx.graphics/com.sun.glass.ui.gtk.GtkApplication.lambda$new$6(Unknown Source)
	at java.base/java.security.AccessController.doPrivileged(Native Method)
	at javafx.graphics/com.sun.glass.ui.gtk.GtkApplication.<init>(Unknown Source)
	at javafx.graphics/com.sun.glass.ui.gtk.GtkPlatformFactory.createApplication(Unknown Source)
	at javafx.graphics/com.sun.glass.ui.Application.run(Unknown Source)
	at javafx.graphics/com.sun.javafx.tk.quantum.QuantumToolkit.startup(Unknown Source)
	at javafx.graphics/com.sun.javafx.application.PlatformImpl.startup(Unknown Source)
	at javafx.graphics/com.sun.javafx.application.PlatformImpl.startup(Unknown Source)
	at javafx.graphics/com.sun.javafx.application.LauncherImpl.startToolkit(Unknown Source)
	at javafx.graphics/com.sun.javafx.application.LauncherImpl.launchApplicationWithArgs(Unknown Source)
	at javafx.graphics/com.sun.javafx.application.LauncherImpl.launchApplication(Unknown Source)
	... 5 more

Internal Error (on Linux)

This so far only happened with version v0.12.0-beta and is fixed in v0.12.1-beta, so just upgrade your installer via:

snap refresh easy-installer --channel=latest/beta

You may have to prepend sudo to the command above.

Full error is

Exception in thread “main” java.lang.reflect.InvocationTargetException
at java.base/jdk.internal.reflect.NativeMethodAccessorImpl.invoke0(Native Method)
at java.base/jdk.internal.reflect.NativeMethodAccessorImpl.invoke(Unknown Source)
at java.base/jdk.internal.reflect.DelegatingMethodAccessorImpl.invoke(Unknown Source)
at java.base/java.lang.reflect.Method.invoke(Unknown Source)
at java.base/sun.launcher.LauncherHelper$FXHelper.main(Unknown Source)
Caused by: java.lang.UnsupportedOperationException: Internal Error
at javafx.graphics/com.sun.glass.ui.gtk.GtkApplication.lambda$new$6(Unknown Source)
at java.base/java.security.AccessController.doPrivileged(Native Method)
at javafx.graphics/com.sun.glass.ui.gtk.GtkApplication.(Unknown Source)
at javafx.graphics/com.sun.glass.ui.gtk.GtkPlatformFactory.createApplication(Unknown Source)
at javafx.graphics/com.sun.glass.ui.Application.run(Unknown Source)
at javafx.graphics/com.sun.javafx.tk.quantum.QuantumToolkit.startup(Unknown Source)
at javafx.graphics/com.sun.javafx.application.PlatformImpl.startup(Unknown Source)
at javafx.graphics/com.sun.javafx.application.PlatformImpl.startup(Unknown Source)
at javafx.graphics/com.sun.javafx.application.LauncherImpl.startToolkit(Unknown Source)
at javafx.graphics/com.sun.javafx.application.LauncherImpl.launchApplicationWithArgs(Unknown Source)
at javafx.graphics/com.sun.javafx.application.LauncherImpl.launchApplication(Unknown Source)
… 5 more

Installer hangs after unlock instructions in “Start device in Fastboot mode” (on Windows)

If detection of the phone in fastboot mode fails on Windows (also when a manual fastboot devices doesn’t see the phone) you might have to install extra drivers.

For detailed instructions (incl. Screenshots) see [HOWTO] Fairphone 3/3+ stuck in fastboot/bootloader mode with the Easy Installer on Windows or FP3+ no USB conection via fastboot, unlocking bootloader not possible - #6 by andrelam

Phone is not detected when using the easy-installer inside a virtual machine

At the time of writing, the easy-installer does not support MacOS yet so people with an Apple computer may try to use the installer inside a VM.

At least for VirtualBox it is important to attach the connected phone to the VM both when the phone is booted normally and also when it is in fastboot/bootloader mode.

More details can be found in How to pass "rebooting in bootloader mode" in Easy Installer - #24 by underdog

Problems compiling the installer

$JAVA_HOME not set

To compile the easy-installer the $JAVA_HOME environment variable needs to be set. See Can't compile easy installer

The error message is not very helpful in this case, it just outputs the following:

./gradlew dist

[...]

> Task :prepareMergedJarsDir FAILED
:prepareMergedJarsDir (Thread[Task worker for ':',5,main]) completed. Took 0.0 secs.

FAILURE: Build failed with an exception.

* What went wrong:
Execution failed for task ':prepareMergedJarsDir'.
> No value has been specified for this provider.

To see a more detailed compile log, execute

./gradlew dist --debug --stacktrace

Running in IntelliJ: JavaFXPlugin has been compiled by a more recent version of the Java Runtime

The full error message is

Cause: org/openjfx/gradle/JavaFXPlugin has been compiled by a more recent version of the Java Runtime (class file version 55.0), this version of the Java Runtime only recognizes class file versions up to 52.0

This can be fixed by selecting a JDK with version 11 as “Gradle JVM” in the IntelliJ settings:

By default, IntelliJ uses a bundled JVM which is not new enough.

3 Likes
Easy Installer on Win 10 w/ FP3+ : device not detected
The /e/OS Easy Installer now supports the FP3 & FP3+, and its contributor tells us all about it
Easy installer - "continue" button not visible
Easy Install on S7 G930F | Android Debug?
Easy Installer failed - Fairphone 3 blocked on fastboot mode
GS290 easy-installer stops
FP3+ easy installer just stops
Stuck on fastboot flashing unlock(Now Black screen)
GS290 easy-installer stops
Install /e/ on Gigaset GS290, Windows, using Easy Installer success second pass
[SOLVED] Gigaset GS290 + Windows 10 + Easy installer = Local file cannot be found (recovery-e-lastest-gs290.img)
How to pass "rebooting in bootloader mode" in Easy Installer
GS290 easy-installer stops
E OS auf Fairphone 3 installieren
Stuck with "could not unpack /e/ install archive" Easy-installer - FP3 - Windows - fastboot/bootloader
Fairphone 3 and /e/OS
Gigaset 290 (GS290-not preinstalled /e/) Bricked
Black screen, don't start
[LIST] Devices working with the Easy Installer
Easy Installer bleibt stehen
Fairphone stuck in unlocked boot loader & easy installer crashed
Easy installer does not find GS290
/e/ installé avec easy installer sur GS290... le téléphone ne démarre plus
Install easy-installer on Fedora
Installing /e/ on Fairphone 2
Fix for: stuck during installation when you are in Fastboot mode
Installation auf Fairphone3+ lässt sich mit easy-installer nicht fortführen
Need help using easy-installer with S6
Newbie having problems with installing on Samsung S7, device is not found
Easy-Install not working on Ubuntu
Can’t find 'Keep Read Only' with Galaxy S9 (with Easy Installer)
/e/ easy installer Samsung Galaxy S7 no TEAMWIN? Help please

Hi,
when will be the next /e/installer release ?

Edit : i mean with more devices

The easy installer is open for developers from the community to update. If there are users who would want to upgrade the Easy Installer they are welcome to modify the code.

The documentation to get someone started adding new devices is at: https://gitlab.e.foundation/e/tools/easy-installer/-/wikis/home

If you want a rough breakdown of the steps involved, see

Just updates my FP3 from and. 9 to and. 10 using Easy Installer on Manjaro linux. Superb.
Lots off data is stored on /e/cloud, perfect for me.

Thanks a lot!

1 Like

The missing driver seem to be a frequent error. Do you see a possibility to include a mention of this in your howto? There are multiple ways of solving it (different drivers). No idea which one is the best practice.

Well, there is already one entry about missing drivers what do you think is missing there (except the full solution which is so long I’d rather not include it here but point to the existing post with all the details and screenshots)?

My idea behind the existing entries of this troubleshooting document was to describe the situation people might find themselves in and then give hints how to solve it or at least where to find more information.

Talking about “missing drivers”: I probably missed some people’s issues but the ones I remember should be covered by the " Installer hangs after unlock instructions in “Start device in Fastboot mode” (on Windows)" section.
If someone writes a Howto install necessary drivers in Windows I’d happily link it from here if the existing one is not sufficient (I found it to be helpful in the situation where fastboot cannot detect the phone).

Sorry, I didn’t see the section. Adding a screenshot to the section of the moment where easy-installer hangs would increase visibility.

1 Like

Bonjour Piero,
excusez-moi de passer par ici, mais je ne savais comment vous contacter.
Je suis un Finistérien de 67 ans qui boycotte les GAFAM.
Mon ordi est sous Linux Mint. Je ne connaissais pas l’existence de /e/ quans j’ai acheté mon FP3 chez Orange.
Je voudrais donc installer /e/ mais je n’y arrive pas. J’ai installé Easy installer et suivi toutes les procédures jusqu’à l’étape “transfert de fichiers” comprise, mais ensuite easy installer ne trouve pas mon téléphone. Il semble quela procédure de déblocage du bootloader ne marche pas, pourtant je suis la procédure décrite sur le site de Fairphone, avec le code de déblocage". Rien, j’ai essayé +eurs fois.
J’ai passé près de 6h à m’acharner sur ce machin et je ne sais plus quoi faire. L’aide de Ingo FP Angel ne m’a pas permis d’avancer.
Pouvez-vous quelquechose pour moi?
Merci
Yves

Can someone please add an topic or a point out an emergency case when a phone get bricked.

Gigaset 290 (Android 9)
Fedora 33 (unstable)

1 Like