Start by downloading BitBoxApp

Windows: sha256sum - a98e49255b19920b940d92c5c4531e75900bcdd9ed139630d17ef404b3569a60 - signature
Mac: sha256sum - 1fbe0d4ae09a2aaf35f78c4ef3ba79743d7d5591109340968b816b088144a4b1 - signature

Linux64 Ubuntu/Debian

Linux64 Fedora

Linux64 Other Distros

Linux64 Ubuntu / Debian Download (v4.15.0)
sha256sum - 6990728741a35074b02dbf31b720914f2325909d050550b1f9bbd0a8e5e48c79

signature

Linux64 Fedora Download (v4.15.0)
sha256sum - a406c5503ee03e5c73c5e324ab207bc8a36a236979a6c6b1d565430a4842d7b8

signature

Linux64 Other - AppImage (v4.15.0)
sha256sum - ea57b0af5ca8ff272c0da466f87d191c57546788cc49547a4f9d8edd06334417

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.15.0/bitbox_4.15.0_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