amnezia-vpn/amnezia-client

Fork 0

mirror of https://github.com/amnezia-vpn/amnezia-client.git synced 2026-10-16 06:11:57 +00:00

[GH-ISSUE #1648] Linux installer could not find the Qt platform plugin "wayland" in "" #701

New issue

Open

opened 2026-10-13 20:26:47 +00:00 by bsakaguchi · 7 comments

bsakaguchi commented

2026-10-13 20:26:47 +00:00

Owner

Originally created by @M-UnityDev on GitHub (Jun 13, 2025).
Original GitHub issue: https://github.com/amnezia-vpn/amnezia-client/issues/1648

Linux installer for version 4.8.7.2 throws an error when executed on wayland:

qt.qpa.plugin: Could not find the Qt platform plugin "wayland" in ""
This application failed to start because no Qt platform plugin could be initialized. Reinstalling the application may fix this problem.

Available platform plugins are: minimal, xcb.

To reproduce the behavior, launch AmneziaVPN_Linux_Installer.bin in Wayland compositor/DE

Desktop:

OS: Arch Linux
Version: 4.8.7.2

Originally created by @M-UnityDev on GitHub (Jun 13, 2025). Original GitHub issue: https://github.com/amnezia-vpn/amnezia-client/issues/1648 Linux installer for version 4.8.7.2 throws an error when executed on wayland: ``` qt.qpa.plugin: Could not find the Qt platform plugin "wayland" in "" This application failed to start because no Qt platform plugin could be initialized. Reinstalling the application may fix this problem. Available platform plugins are: minimal, xcb. ``` To reproduce the behavior, launch AmneziaVPN_Linux_Installer.bin in Wayland compositor/DE **Desktop:** - OS: Arch Linux - Version: 4.8.7.2

bsakaguchi commented

2026-10-13 20:26:48 +00:00

Author

Owner

@tenchas commented on GitHub (Jun 22, 2025):

I've just had the same problem;
Installer requires X session, so it doesn't work on pure wayland;
To resolve the issue, you should install xorg-xwayland package, reboot the system/restart the session and you'll get working X apps, including the installer;

Hope it helps;

@tenchas commented on GitHub (Jun 22, 2025): I've just had the same problem; Installer requires **X session**, so it doesn't work on pure wayland; To resolve the issue, you should **install** `xorg-xwayland` package, reboot the system/restart the session and you'll get working X apps, including the installer; Hope it helps;

bsakaguchi commented

2026-10-13 20:26:48 +00:00

Author

Owner

@M-UnityDev commented on GitHub (Jun 23, 2025):

I forgot to mention that but I have xorg-xwayland installed

Also I solved this issue by running the installer with QT_QPA_PLATFORM=xcb

@M-UnityDev commented on GitHub (Jun 23, 2025): I forgot to mention that but I have xorg-xwayland installed Also I solved this issue by running the installer with ```QT_QPA_PLATFORM=xcb```

bsakaguchi commented

2026-10-13 20:26:48 +00:00

Author

Owner

@m0rphed commented on GitHub (Feb 6, 2026):

Same happening on fresh AmneziaVPN version 4.8.12.9 f737928 - which also prevents Amnezia systemd-service properly starting on login under Wayland.
Both xorg-xwayland and qt6-wayland packages are installed in my case. It doesn't seem to be some "well-known QT-Wayland problem", because other QT Apps works just fine without any tweaking or necessary switching to XWayland.

For now, on Wayland, I didn't find any other workaround other than changing QT platform environment variable like this: QT_QPA_PLATFORM=xcb ; AmneziaVPN - which require manually starting Amnezia on each login 😿

@m0rphed commented on GitHub (Feb 6, 2026): Same happening on fresh AmneziaVPN version 4.8.12.9 `f737928` - which also prevents Amnezia systemd-service properly starting on login under Wayland. Both `xorg-xwayland` and `qt6-wayland` packages are installed in my case. It doesn't seem to be some "well-known QT-Wayland problem", because other QT Apps works just fine without any tweaking or necessary switching to XWayland. For now, on Wayland, I didn't find any other workaround other than changing QT platform environment variable like this: `QT_QPA_PLATFORM=xcb ; AmneziaVPN` - which require manually starting Amnezia on each login 😿

bsakaguchi commented

2026-10-13 20:26:49 +00:00

Author

Owner

@nartamonov commented on GitHub (Mar 13, 2026):

@M-UnityDev I think we should reopen the issue. Yes, there are manual workaround, but the core cause was not fixed: right now the installer and the application binary do not work out-of-the-box in Linux distributions that explicitly require Qt apps to use wayland (set QT_QPA_PLATFORM=wayland on system-wide level). I think it affects Arch, CachyOS, and other popular distributions. Amnezia could detect it and explicitly reset the platform to xcb in that case. Currently I have to patch start-up script AmneziaVPN.sh after installation:

# ...

if [[ "$QT_QPA_PLATFORM" == "wayland" ]]; then
  export QT_QPA_PLATROFM=xcb
fi

# ... run application binary ...

@nartamonov commented on GitHub (Mar 13, 2026): @M-UnityDev I think we should reopen the issue. Yes, there are manual workaround, but the core cause was not fixed: right now the installer and the application binary do not work out-of-the-box in Linux distributions that explicitly require Qt apps to use wayland (set QT_QPA_PLATFORM=wayland on system-wide level). I think it affects Arch, CachyOS, and other popular distributions. Amnezia could detect it and explicitly reset the platform to `xcb` in that case. Currently I have to patch start-up script `AmneziaVPN.sh` after installation: ```bash # ... if [[ "$QT_QPA_PLATFORM" == "wayland" ]]; then export QT_QPA_PLATROFM=xcb fi # ... run application binary ... ```

bsakaguchi commented

2026-10-13 20:26:49 +00:00

Author

Owner

@nartamonov commented on GitHub (Mar 17, 2026):

@scar28s so it's open source, if core developers do not interested fixing the issue, maybe community devs will do it someday. Interestingly enough, there are merged contributions to fix compatibility with SteamOS 😃

@nartamonov commented on GitHub (Mar 17, 2026): @scar28s so it's open source, if core developers do not interested fixing the issue, maybe community devs will do it someday. Interestingly enough, there are merged [contributions](https://github.com/amnezia-vpn/amnezia-client/commit/1d721ffb9abb4c0c5a123f33edb5c066a6eee40b) to fix compatibility with SteamOS :smiley:

bsakaguchi commented

2026-10-13 20:26:50 +00:00

Author

Owner

@doonto commented on GitHub (Mar 30, 2026):

Another option for manual workaround is:

sudo sed -i 's|^Exec=.*|Exec=env QT_QPA_PLATFORM=xcb AmneziaVPN %U|' /usr/share/applications/AmneziaVPN.desktop
sudo update-desktop-database /usr/share/applications/

@doonto commented on GitHub (Mar 30, 2026): Another option for manual workaround is: ``` sudo sed -i 's|^Exec=.*|Exec=env QT_QPA_PLATFORM=xcb AmneziaVPN %U|' /usr/share/applications/AmneziaVPN.desktop sudo update-desktop-database /usr/share/applications/ ```

bsakaguchi commented

2026-10-13 20:26:50 +00:00

Author

Owner

@levamak commented on GitHub (Jun 16, 2026):

hello guys, found another solution for launching amnezia in wayland:

tested on CachyOS with working amnezia when launched from terminal like this QT_QPA_PLATFORM=xcb AmneziaVPN

in terminal type which AmneziaVPN , should give you an output like this : /usr/local/sbin/AmneziaVPN
open this file in any editor with sudo permission (example : sudo micro /usr/local/sbin/AmneziaVPN )
in the file, at the start of the script add a line QT_QPA_PLATFORM=xcb
now the script should look something like this:

# commented section, ignore
QT_QPA_PLATFORM=xcb # added line
BASE_DIR=$(dirname "$(readlink -f "$0")") # start of initial code
export PATH="$BASE_DIR"/bin/:$PATH
...

after this change amnezia works normally even if launching from launcher (i tested it in noctalia launcher)

@levamak commented on GitHub (Jun 16, 2026): hello guys, found another solution for launching amnezia in wayland: tested on CachyOS with working amnezia when launched from terminal like this `QT_QPA_PLATFORM=xcb AmneziaVPN` in terminal type `which AmneziaVPN` , should give you an output like this : `/usr/local/sbin/AmneziaVPN` open this file in any editor with sudo permission (example : `sudo micro /usr/local/sbin/AmneziaVPN` ) in the file, at the start of the script add a line `QT_QPA_PLATFORM=xcb` now the script should look something like this: ``` # commented section, ignore QT_QPA_PLATFORM=xcb # added line BASE_DIR=$(dirname "$(readlink -f "$0")") # start of initial code export PATH="$BASE_DIR"/bin/:$PATH ... ``` after this change amnezia works normally even if launching from launcher (i tested it in noctalia launcher)

bsakaguchi referenced this issue

2026-10-13 21:17:56 +00:00

[PR #701] [MERGED] Bugfix/linux tries ipv6 and hangs only browsers work #2042