The BitBoxApp AppImage offers a convenient way to use the BitBox02 hardware wallet on various Linux distributions. This guide will walk you through the installation process, ensuring your device is recognized and ready for use.

Step 1: Download the BitBoxApp AppImage

Visit the official BitBox download page and download the latest AppImage version suitable for your system.

Step 2: Make the AppImage executable

Open your terminal and navigate to the directory where the AppImage was downloaded. Then, execute the following commands:

cd ~/Downloads
chmod +x ./BitBox-[version]-x86_64.AppImage

Replace [version] with the actual version number of the AppImage you downloaded.

Step 3: Run the BitBoxApp

To start the application, run:

./BitBox-[version]-x86_64.AppImage

The BitBoxApp should now launch, allowing you to interact with your BitBox02 device.

Troubleshooting: device not detected

If your BitBox02 is not recognized by the app, you may need to adjust USB permissions.

Adjust USB permissions

For most modern Linux distributions, execute the following commands:

sudo tee /etc/udev/rules.d/53-hid-bitbox02.rules > /dev/null <<EOF
SUBSYSTEM=="usb", TAG+="uaccess", TAG+="udev-acl", SYMLINK+="bitbox02_%n", ATTRS{idVendor}=="03eb", ATTRS{idProduct}=="2403"
EOF

sudo tee /etc/udev/rules.d/54-hid-bitbox02.rules > /dev/null <<EOF
KERNEL=="hidraw*", SUBSYSTEM=="hidraw", ATTRS{idVendor}=="03eb", ATTRS{idProduct}=="2403", TAG+="uaccess", TAG+="udev-acl", SYMLINK+="bitbox02_%n"
EOF

sudo udevadm control --reload
sudo udevadm trigger

After running these commands, unplug and replug your BitBox02 device.

Add user to plugdev group

If the issue persists, add your user to the plugdev group:

sudo usermod -aG plugdev $(whoami)

Then, reboot your system to apply the changes.

Additional tips

Checksum verification: 

To ensure the integrity of the downloaded AppImage, verify its SHA-256 checksum:

  sha256sum BitBox-[version]-x86_64.AppImage

Compare the output with the checksum provided on the BitBox download page.

If you are using Tor, the proxy information is required:

curl -O --socks5 [url]

Downloading via curl: 

If you encounter issues with the browser download, use curl to download the AppImage:

  curl -O https://github.com/digitalbitbox/bitbox-wallet-app/releases/download/v[version]/BitBox-[version]-x86_64.AppImage

Replace [version] with the desired version number.

By following this guide, you should have the BitBoxApp up and running on your Linux system, ready to manage your cryptocurrencies securely.