Troubleshooting

Getting help

• Mailing list: groups.io/g/klog
• Telegram (English): t.me/klogchat
• Telegram (Spanish / Español): t.me/KLogES
• Bug reports / feature requests: open an issue on the KLog GitHub repository.

When asking for help, include your KLog version (Help → About), your operating system, and, if relevant, the exact error message shown.

Known issues

Linux — Raspbian / other Wayland-only setups

Error message in the console when KLog starts:

qt.qpa.plugin: Could not find the Qt platform plugin "wayland" in ""

Solution: install the Qt Wayland package:

sudo apt install qt6-wayland

See also Installation on Linux.

Where KLog stores its data

• On Linux, KLog's configuration and data are kept under ~/.klog/: klogrc (your callsign/locator/preferences) and logbook.dat (your logbook database). The DXCC entity data (cty.csv) may also be installed under a shared data directory (e.g. /usr/share/klog/cty.csv).
• You can view and change the database location from Settings → Miscellaneous → Move DB, for example to move it into a cloud-synced folder (Google Drive, Dropbox, etc.) so the same logbook can be used from more than one device — see the note on the Home page.

If KLog isn't starting, isn't finding your radio, or isn't syncing with an online service, check the relevant page first: Radio Interfaces, WSJT-X / UDP Integration, or the Settings reference — then ask on the mailing list/Telegram above if the problem persists.

[ADD SCREENSHOT HERE: any recurring error dialog worth documenting here, with its exact wording and the fix, as new issues are identified]