From a5cfd3512059aeab26b6609d59c402aa30b7de7d Mon Sep 17 00:00:00 2001 From: Iceman Date: Tue, 3 Mar 2026 12:23:20 +0100 Subject: [PATCH] Update Troubleshooting.md Signed-off-by: Iceman --- .../Troubleshooting.md | 29 +++++++++++++++++++ 1 file changed, 29 insertions(+) diff --git a/doc/md/Installation_Instructions/Troubleshooting.md b/doc/md/Installation_Instructions/Troubleshooting.md index 043ac8bef..b008f1914 100644 --- a/doc/md/Installation_Instructions/Troubleshooting.md +++ b/doc/md/Installation_Instructions/Troubleshooting.md @@ -30,6 +30,7 @@ Always use the latest repository commits from *master* branch. There are always - [found architecture 'x86\_64' required architecture 'arm64' error](#found-architecture-x86_64-required-architecture-arm64-error) - [wrong permissions on runtime directory /run/user/1000](#wrong-permissions-on-runtime-directory-runuser1000) - [proxspace 'file not found or locked' on Windows 11](#proxspace-file-not-found-or-locked-on-windows-11) + - [qt.qpa.plugin: Could not find the Qt platform plugin 'wayland' error](#qtqpaplugin-could-not-find-the-qt-platform-plugin-wayland-error) ## `pm3` or `pm3-flash*` doesn't see my Proxmark @@ -391,3 +392,31 @@ Side note: You may also be able to choose "Browse all apps" and find your specific proxmark3.exe in the client folder but be sure to choose the proper location and specific file in case you have more than one stored on your PC somewhere. ``` + +## qt.qpa.plugin: Could not find the Qt platform plugin 'wayland' error +^[Top](#top) + +If you run into this error message when running on modern Ubuntu which is using the wayland display +you most likely have not installed these following packages. + +Solution: Install or reinstall the required Qt Wayland packages. + +``` +Debian / Ubuntu based *nix + sudo apt install qt5-qtwayland --< if QT 5 + sudo apt install qt6-qtwayland --< if QT 6 + +Arch *nix + pacman -S qt5-wayland + pacman -S qt6-wayland +``` + + +Alternatively you could set QT_QPA_PLATFORM environment to either wayland or xcb +``` +export QT_QPA_PLATFORM=wayland + +export QT_QPA_PLATFORM=xcb +``` + +