The launcher doesn't open on Linux

Applies to: Linux

Topic: Linux and crashes

You start the AppImage and nothing appears, it shows as running with no window, or you get "permission denied".

Permission denied

The AppImage isn't executable yet:

chmod +x FH2MP-Launcher-*.AppImage
./FH2MP-Launcher-*.AppImage

Running but no window

The launcher keeps your account key in your desktop's keyring and waits for it to unlock. Look for a keyring or password prompt (it may be behind other windows) and unlock it. The launcher shows Waiting for your system keyring while it waits.

If your system has no keyring (some minimal desktops), start the launcher without it:

FH2MP_NO_KEYRING=1 ./FH2MP-Launcher-*.AppImage

The key is then stored in a private file in your launcher folder instead. If your account key was saved in the keyring before, the launcher can't read it this way: have your recovery code ready and use I have a recovery code.

Wayland problems

If the window flickers or doesn't draw, try X11 mode:

QT_QPA_PLATFORM=xcb ./FH2MP-Launcher-*.AppImage

Still nothing

Run the AppImage from a terminal and copy what it prints. Report it on GitHub with your distribution, desktop (KDE, GNOME, ...) and whether you use X11 or Wayland. The .deb package is an alternative on Debian and Ubuntu.