Documentation contents

Install Gadka on Linux

You can install Gadka for your own account without administrator privileges.

Requirements

  • You need x86-64 or arm64 Linux with glibc 2.36 or later (Debian 12 or equivalent, or newer).
  • Your desktop environment needs a working keyring, such as GNOME Keyring. Gadka uses it to store your credentials.

Download the installer

Choose the installer for your processor on the download page.

ProcessorFile
x86-64gadka-linux-amd64.run
arm64gadka-linux-arm64.run

Install the app

Run the installer as your regular user, without sudo. The commands below are for x86-64. On arm64, use gadka-linux-arm64.run.

chmod +x gadka-linux-amd64.run
./gadka-linux-amd64.run

Expected output (in Polish):

Zainstalowano Gadka <wersja> w /home/jan/.local/share/gadka
Uruchom: /home/jan/.local/bin/gadka

The installer unpacks the app into ~/.local/share/gadka, creates a symbolic link at ~/.local/bin/gadka and adds Gadka to the applications menu.

Open Gadka

Choose Gadka from the applications menu or run this command in a terminal:

~/.local/bin/gadka

Choose a different installation directory

Use these environment variables to change the installation paths.

VariableDefaultPurpose
GADKA_INSTALL_PREFIX~/.local/share/gadkaApp directory
GADKA_BIN_DIR~/.local/binDirectory for the symbolic link
GADKA_INSTALL_PREFIX=$HOME/apps/gadka ./gadka-linux-amd64.run

System tray

When you close the window, Gadka stays in the system tray and keeps receiving messages. The tray icon’s menu includes Show Gadka, Check for updates and Quit.

Uninstall Gadka

./gadka-linux-amd64.run --uninstall

The installer confirms removal with Gadka została odinstalowana. If you specified custom directories during installation, set the same variables when uninstalling.

Troubleshooting

SymptomWhat to check
Gadka forgets your credentials or shows an error when you sign inCheck that your keyring’s Secret Service is running, for example via gnome-keyring.
The tray icon is missingCheck that your desktop environment supports tray icons (AppIndicator).
A GLIBC version error appears at startupCheck whether your system is older than Debian 12.