Learn how to install the BitBoxApp on Linux using the official DEB or RPM package.

Before you begin

Before installing the BitBoxApp on Linux:

• Use a supported Linux distribution. Check the BitBoxApp operating system compatibility article before installing the BitBoxApp on Linux.
• Download the BitBoxApp only from the official BitBoxApp download page.
• You do not need to connect your BitBox during installation.
• You do not need your microSD backup or recovery words to install the BitBoxApp.

Choose the right Linux package

Download the package that matches your Linux distribution:

• Use the .deb package for Debian-based distributions such as Debian, Ubuntu, Linux Mint, Pop!_OS, and Zorin OS.
• Use the .rpm package for RPM-based distributions such as Fedora, openSUSE, and Red Hat Enterprise Linux compatible distributions.

If you prefer a portable app file instead of installing a package, follow the BitBoxApp AppImage installation guide for Linux.

Install the BitBoxApp on Linux

1. Download the latest Linux package from the official BitBoxApp download page.
2. Open the downloaded .deb or .rpm package.
3. Install the package using your system package manager.
4. If your Linux system asks for confirmation or your administrator password, approve the installation only if you downloaded the package from the official BitBoxApp download page.
5. Open the BitBoxApp after the installation is complete.
6. Connect and unlock your BitBox if you want to start using your wallet.

Result:

The BitBoxApp is installed on your Linux computer.

Verify the BitBoxApp download

Only install the BitBoxApp from the official BitBoxApp download page.

For an additional verification step, you can check the BitBoxApp checksum. The BitBoxApp checksum verification guide explains how to confirm that the downloaded Linux package matches the file published by BitBox.

Advanced users can also verify the BitBoxApp signature on Linux. The Linux BitBoxApp signature verification guide explains how to confirm that the downloaded package was signed by Shift Crypto.

Update BitBox firmware after installing the BitBoxApp

Installing the BitBoxApp and updating BitBox firmware are separate processes.

If a newer firmware version is available for your BitBox, the BitBoxApp will guide you through the firmware update after you connect and unlock your BitBox.

For detailed instructions, see the BitBox firmware update guide.

Problems installing the BitBoxApp on Linux

If the package does not open, your package manager reports an installation error, or the BitBoxApp does not start after installation, follow the BitBoxApp Linux installation troubleshooting guide.

Frequently asked questions

Can I install the BitBoxApp on Linux without connecting my BitBox?

Yes. You can install the BitBoxApp on Linux without connecting your BitBox. Connect and unlock your BitBox after installation if you want to use your wallet.

Which Linux package should I download for the BitBoxApp?

Use the .deb package for Debian-based distributions such as Debian, Ubuntu, Linux Mint, Pop!_OS, and Zorin OS. Use the .rpm package for RPM-based distributions such as Fedora, openSUSE, and Red Hat Enterprise Linux compatible distributions.

Should I use the BitBoxApp Linux package or the AppImage?

Use the Linux package if your distribution supports the official .deb or .rpm format. Use the AppImage if you prefer a portable app file or if your distribution does not use DEB or RPM packages. Learn how to install the BitBoxApp AppImage on Linux.

Do I need to uninstall an older BitBoxApp version before installing a new one?

No. In most cases, installing the latest Linux package updates the existing BitBoxApp installation. You do not need to uninstall the older version first.

Which Linux distributions are supported by the BitBoxApp?

Supported Linux distributions are listed in the BitBoxApp operating system compatibility article.

Can I install the BitBoxApp before receiving my BitBox?

Yes. You can install and open the BitBoxApp before your BitBox arrives. You can also use Bitcoin Testnet to try selected BitBoxApp features without using real funds.

To learn more, see the Bitcoin Testnet with BitBoxApp guide.