Start by downloading BitBoxApp

Windows: sha256sum - b32dddab2345f793f70aa026301cc818dfb3f29ee63b2f5728a8d0513b534dd8 - signature
Mac: sha256sum - b1587498ac38b403d0b69eb73f5412a5d9748b15cb49940fa8b43c3b12001d79 - signature

Linux64 Ubuntu/Debian

Linux64 Fedora

Linux64 Other Distros

Linux64 Ubuntu / Debian Download (v4.13.1)
sha256sum - 9e701836b65f67ba55c1803ff25550ce75c896f293b1124427bb12c6608e1308

signature

Linux64 Fedora Download (v4.13.1)
sha256sum - 4f9dece473fe98cb4845a0fd20adc3c49039d3d01e54099417a8d6e52364255e

signature

Linux64 Other - AppImage (v4.13.1)
sha256sum - 5f6daacf19cf42da161465465f7ecc3cd0278278ff6ed1d287a3308d680828e8

signature

The AppImage is a stand-alone desktop app. Uncompress the file by double-clicking or entering in a terminal:

cd ~/Downloads # navigate to your download folder
chmod +x ./BitBox-[version]-x86_64.AppImage # make executable
./BitBox-[version]-x86_64.AppImage # to run the app

* If the BitBox device is not detected by the app, you may need to manually adjust USB permissions. To do this for most recent distributions, enter the following line in a terminal (sudo access required), then replug the device:

printf "SUBSYSTEM==\"usb\", TAG+=\"uaccess\", TAG+=\"udev-acl\", SYMLINK+=\"bitbox02_%%n\", ATTRS{idVendor}==\"03eb\", ATTRS{idProduct}==\"2403\"\n" | sudo tee /etc/udev/rules.d/53-hid-bitbox02.rules > /dev/null && printf "KERNEL==\"hidraw*\", SUBSYSTEM==\"hidraw\", ATTRS{idVendor}==\"03eb\", ATTRS{idProduct}==\"2403\", TAG+=\"uaccess\", TAG+=\"udev-acl\", SYMLINK+=\"bitbox02_%%n\"\n" | sudo tee /etc/udev/rules.d/54-hid-bitbox02.rules > /dev/null
printf "SUBSYSTEM==\"usb\", TAG+=\"uaccess\", TAG+=\"udev-acl\", SYMLINK+=\"dbb%%n\", ATTRS{idVendor}==\"03eb\", ATTRS{idProduct}==\"2402\"\n" | sudo tee /etc/udev/rules.d/51-hid-digitalbitbox.rules > /dev/null && printf "KERNEL==\"hidraw*\", SUBSYSTEM==\"hidraw\", ATTRS{idVendor}==\"03eb\", ATTRS{idProduct}==\"2402\", TAG+=\"uaccess\", TAG+=\"udev-acl\", SYMLINK+=\"dbbf%%n\"\n" | sudo tee /etc/udev/rules.d/52-hid-digitalbitbox.rules > /dev/null

Or, if the above does not work for your distribution, add yourself to the 'plugdev' group (if not already a member; a reboot may be required for some distributions) and enter the following line in a terminal (sudo access required):

printf "SUBSYSTEM==\"usb\", SYMLINK+=\"bitbox02_%%n\", GROUP=\"plugdev\", MODE=\"0664\", ATTRS{idVendor}==\"03eb\", ATTRS{idProduct}==\"2403\"\n" | sudo tee /etc/udev/rules.d/53-hid-bitbox02.rules > /dev/null && printf "KERNEL==\"hidraw*\", SUBSYSTEM==\"hidraw\", SYMLINK+=\"bitbox02_%%n\", GROUP=\"plugdev\", MODE=\"0664\", ATTRS{idVendor}==\"03eb\", ATTRS{idProduct}==\"2403\"\n" | sudo tee /etc/udev/rules.d/54-hid-bitbox02.rules > /dev/null
printf "SUBSYSTEM==\"usb\", SYMLINK+=\"dbb%%n\", GROUP=\"plugdev\", MODE=\"0664\", ATTRS{idVendor}==\"03eb\", ATTRS{idProduct}==\"2402\"\n" | sudo tee /etc/udev/rules.d/51-hid-digitalbitbox.rules > /dev/null && printf "KERNEL==\"hidraw*\", SUBSYSTEM==\"hidraw\", SYMLINK+=\"dbbf%%n\", GROUP=\"plugdev\", MODE=\"0664\", ATTRS{idVendor}==\"03eb\", ATTRS{idProduct}==\"2402\"\n" | sudo tee /etc/udev/rules.d/52-hid-digitalbitbox.rules > /dev/null

* If the sha256sum checksum does not match, your browser may have requested a second level of gz compression. In this case, a clean download can be made with curl, for example:

curl -O https://github.com/digitalbitbox/bitbox-wallet-app/releases/download/v4.13.1/bitbox_4.13.1_amd64.deb

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

curl -O --socks5 [url]

Select your device:

BitBox01

BitBox02

Step 1: Download the BitBoxApp

To get started, download the BitBoxApp using the links above.

Step 2: Plug in your BitBox01

Insert the microSD card into BitBox01 and plug it into your computer.

Step 3: Set up your BitBox01

Open the BitBoxApp and follow the on-screen instructions to set-up your BitBox01.

Step 4: Remember your password

Remember the device password, and keep a copy of it somewhere safe.

Step 5: Remove the microSD card and store it somewhere safe

The backup and device password can be used to recover your wallet. Check out the Backup Center to learn how a backup can be recovered without a BitBox or to learn how to load your own wallet.

Step 1: Download the BitBoxApp

To get started, download the BitBoxApp using the links above.

Step 2: Plug in your BitBox02

Insert the microSD card into BitBox02 and plug it into your computer.

Step 3: Set up your BitBox02

Open the BitBoxApp and follow the on-screen instructions to set-up your BitBox02.

Step 4: Remember your password

Remember the device password, and keep a copy of it somewhere safe.

Step 5: Remove the microSD card and store it somewhere safe

The backup and device password can be used to recover your wallet. Check out the Backup Center to learn how a backup can be recovered without a BitBox or to learn how to load your own wallet.

Important: Unlike the BitBox01, the BitBox02 microSD card backup is not encrypted with a password. This means anyone who has access to your microSD card backup has access to your funds!

Stay in control of your digital assets