Install the BitBoxApp on Linux with the official DEB or RPM package, then open it from your applications menu. You can complete installation without connecting a BitBox.

Before you begin

Check the supported Linux distributions and minimum versions first. The official Linux packages are for x86-64 computers, also called amd64; a 64-bit ARM computer cannot use these packages.

Download the BitBoxApp

On the official BitBoxApp download page, choose the download for your distribution:

• Ubuntu / Debian: download the .deb package.
• Fedora / openSUSE: download the .rpm package.

Using the same package format does not by itself make another distribution supported. If you prefer a standalone file instead of a system-wide package, follow Run the BitBoxApp AppImage on Linux. The AppImage still needs a compatible Linux environment.

Wait for the package to finish downloading. If you want to verify the download, do so before opening the file:

• Compare its SHA-256 checksum to check that the file matches the published value. A match does not independently prove who published that value.
• Verify the BitBoxApp signature to check that Shift Crypto signed the file and that it has not changed since signing.

If either check fails, do not open or install the file. Follow the failure guidance in the verification article you used.

If a browser or security tool reports a threat, stop and use the troubleshooting guidance below rather than disabling protection or allowing the file.

Install and open the BitBoxApp

Your system's package installer handles installation and any required dependencies. Its appearance varies by distribution and desktop environment. On a managed work or school computer, ask your device administrator if you do not have permission to install software.

1. In your file manager, open the folder containing the downloaded .deb or .rpm file, then open that file with your system's package installer. If it opens as an archive or no installer is available, use the troubleshooting guide below.
2. Start installation in the package installer. If Linux requests your administrator password or confirmation, authorize installation only for the official package you downloaded. Wait until the installer reports that installation has completed.
3. Open the BitBoxApp from your applications menu.

Installation is complete when the BitBoxApp window opens normally. You can then connect and unlock your BitBox to use your wallet, or follow the app's instructions to set up a new device.

If you are updating an existing installation, the latest matching package normally updates it in place; you do not need to uninstall the previous version first. See the BitBoxApp update guide to confirm the installed version.

If installation or startup fails

If the package will not open, installation reports an error, a security tool blocks the file, or the app will not start, follow BitBoxApp installation fails on Linux. Keep the exact error message and downloaded filename for troubleshooting.

If the app opens but does not detect your connected BitBox, use the Linux device-detection guide for USB permissions and udev rules.