The BitBoxApp AppImage lets you open the app on Linux directly from a downloaded file, without installing a system-wide package. Download the file, give it permission to run, and open it using either your file manager or the terminal. You do not need to connect your BitBox to complete these steps.

Download the BitBoxApp AppImage

Check the supported devices and operating systems before continuing. The official AppImage is for x86-64 Linux computers, also called amd64. Choosing an AppImage does not make an unsupported system compatible. If you prefer to install a DEB or RPM package, follow Install the BitBoxApp on Linux instead.

Open the official BitBoxApp download page, choose AppImage under the Linux downloads, and wait for the download to finish. Keep track of the folder where your browser saves the .AppImage file.

For an additional check before opening the file, you can:

• Compare its SHA-256 checksum to confirm that it matches the file published for that release. A checksum comparison does not independently confirm who signed the file.
• Verify its signature to check whether Shift Crypto signed the file and whether it has remained unchanged since signing.

If either check fails, do not open that file. Follow the verification guide's troubleshooting steps or contact BitBox Support before continuing.

Open the AppImage

Linux needs permission to run the downloaded file as a program. Use the file-manager method below, or use the terminal if you prefer commands or cannot find the permission setting. You only need to follow one method.

Use your file manager

1. Open the folder containing the downloaded AppImage, such as Downloads. Right-click the .AppImage file and select Properties.
2. Under Permissions or Access Rights, enable the option to run the file as a program. Depending on your file manager, it may be called Allow executing file as program or Is executable.
3. Close Properties and double-click the same AppImage to open the BitBoxApp. If your system asks whether to run it, confirm the launch prompt for that file. If it reports a security threat or policy restriction, stop and use the help section below.

Use the terminal

Run these commands as your normal user, without sudo. Replace VERSION in both commands with the version in your downloaded filename, keeping the capitalization and quotation marks. Press Enter after each command.

1. Open a terminal and go to the folder containing the AppImage. If it is in your home folder's Downloads directory, enter:

   cd ~/Downloads

   If you saved it elsewhere, use cd followed by a space and the actual folder path in quotation marks. Continue only when the terminal is in the folder containing your file.
2. Give the file permission to run:

   chmod +x "BitBox-VERSION-x86_64.AppImage"

   If this succeeds, the terminal returns to its prompt without an error. If it reports an error, resolve it before continuing.
3. Open the same file:

   ./"BitBox-VERSION-x86_64.AppImage"

   Keep the ./ at the beginning: it tells the terminal to run the file in the current folder.

Startup is complete when the BitBoxApp window opens. You can now connect and unlock your BitBox if you want to use your wallet. If no window appears, follow the startup guidance below.

Update the AppImage

The BitBoxApp AppImage does not update itself. To update it, close the running BitBoxApp, download the latest AppImage, and follow the download checks and launch steps above for the new file. Use the new AppImage instead of the older one. For version checks, see Update the BitBoxApp.

If the AppImage does not open

If permissions cannot be changed, no window appears, or an error mentions FUSE or libfuse.so.2, follow the Linux installation and startup troubleshooting guide. Keep any terminal error text; if you need Support, include it with your Linux distribution and version and the complete AppImage filename.

If security software reports a threat or a device policy blocks the file, do not disable protection or bypass the restriction. Use the security-block guidance in that troubleshooting guide.

If the app opens but does not detect your BitBox, startup has succeeded. Continue with the Linux device-detection guide.