Installing Alpagua on Debian, Ubuntu and Linux Mint

Alpagua-<version>-linux-x64.deb is the package for Debian 13 and later, and for the systems based on them. On another distribution (Arch Linux, Fedora…), take the archive: see INSTALL.linux.md.

Installing

In the folder of the download:

sudo apt install ./Alpagua-<version>-linux-x64.deb

The ./ matters: without it, apt looks for a package named so in its repositories. apt installs what Alpagua needs with it (GTK 3, libsecret, and GNOME Keyring, where the API keys are kept). A double click on the file, which opens the software center, does the same.

On a system based on Debian other than Debian 13 (Ubuntu, Linux Mint…), apt says whether it has what the package needs: if it refuses for a missing or too old library (libc6…), the system is too old for this package.

Alpagua is then in the menu, under Internet, and alpagua starts it from a terminal. A double click on an .alpagua export archive starts its import. man alpagua describes the command.

The package puts the app in /opt/alpagua, the command in /usr/bin/alpagua, and the menu entry, the icons and the type of the archives where the desktop finds them.

Updating

Install the new package the same way: it replaces the previous version, and your data stays.

Checking a download

On alpagua.com, the SHA-256 link under the download gives its checksum, <file>.sha256. Downloaded next to the file, it shows that the download is whole:

sha256sum -c Alpagua-<version>-linux-x64.deb.sha256

which answers OK (or Réussi…, in the system's language).

Where your data is

• ~/.local/share/com.alpagua.app/: the database (conversations, settings), the imports.
• ~/Alpagua/: your notes, documents and skills, plain files you can open with other apps; the attachments in ~/Alpagua/.attachments.
• The API keys and tokens: in the keyring (the Passwords and Keys app shows them).

Uninstalling

sudo apt remove alpagua

That leaves your data. To remove it too, after an export if you may want it back: rm -rf ~/.local/share/com.alpagua.app ~/Alpagua.

Without GNOME Keyring

On Plasma, KWallet keeps the keys; with KeePassXC, turn on its Secret Service integration. Either way, GNOME Keyring is not needed: sudo apt install --no-install-recommends ./Alpagua-<version>-linux-x64.deb leaves it out. Without any of them, Alpagua runs but cannot remember a key.

← Back to the downloads