Install guide · Linux

Install Arqma Wallet on Linux

Two install paths: the portable AppImage (works on any modern distro) or the tar.gz archive (if you prefer to manage binaries yourself). Both work on x86_64.

Updated June 2026
Arqma Wallet — gold icosahedron vault mark

Choose your install method

  • AppImage — one file, no install, works on Ubuntu, Debian, Fedora, Arch, openSUSE, and more. Recommended for most users.
  • tar.gz — extract to /opt or ~/.local and link manually. Recommended if you maintain your own /usr/local tree.

1. Download

Go to the official download page and grab either Arqma-Wallet-x86_64.AppImage or arqma-wallet-linux-x86_64.tar.gz. Save the matching.sha256 file alongside it.

2. Verify the checksum

cd ~/Downloads sha256sum -c Arqma-Wallet-x86_64.AppImage.sha256

You should see OK next to the filename. Anything else — delete and re-download.

3a. AppImage path

chmod +x Arqma-Wallet-x86_64.AppImage ./Arqma-Wallet-x86_64.AppImage

On first launch most desktops offer to integrate the AppImage (adds a menu entry). Accept it; that’s the easiest way to launch the wallet in the future.

If you get FUSE errors on Ubuntu 22.04+, install the runtime once: sudo apt install libfuse2.

3b. Tarball path

sudo tar -xzf arqma-wallet-linux-x86_64.tar.gz -C /opt/ sudo ln -s /opt/arqma-wallet/arqma-wallet /usr/local/bin/arqma-wallet arqma-wallet

If you want a desktop entry, drop the bundled arqma-wallet.desktop into ~/.local/share/applications/.

4. First launch

The wallet opens to a chooser: Create new wallet or Restore from seed. New users: pick Create. Existing users: see the recovery guide.

5. Password & seed

Use a strong, unique password for local encryption. Then write the 25-word seed phrase on paper. Don’t paste it into a terminal, an editor, or any cloud-synced location. See seed phrase security.

Distro-specific notes

Ubuntu / Debian

AppImage works out of the box on Ubuntu 22.04 / 24.04 once libfuse2 is installed. Snap and Flatpak packages are not official — only use binaries from our download page.

Fedora

Install fuse-libs if the AppImage refuses to start. SELinux usually permits AppImages by default; if it doesn’t, run from a path under your home directory.

Arch / Manjaro

Both AppImage and tarball work without extra packages. Avoid AUR clones unless they explicitly mirror the official release with verified checksums.

Common Linux issues

“Permission denied” when running the AppImage

You forgot chmod +x. Run chmod +x Arqma-Wallet-x86_64.AppImage and try again.

AppImage exits silently

Run it from a terminal to see the error: ./Arqma-Wallet-x86_64.AppImage. Usually it’s missing libfuse2 or a missing GLIBC version on a very old distro.

Wallet doesn’t finish syncing

Networking, not install. See why is my wallet not syncing?

Continue reading