Start by downloading BitBoxApp

Windows: sha256sum - 14879d0d09bae2b0ce0be037fd3c5b663eac67d6b61afe18ea38d50e066aa2b6 - signature
Mac: sha256sum - 68b52968e4a1bdf3fa072e99bff443c3cb2da55fe613057326ef343c9f13f1ea - signature

Linux64 Ubuntu/Debian

Linux64 Fedora

Linux64 Other Distros

Linux64 Ubuntu / Debian Download (v4.16.1)
sha256sum - 6790ad0a59c01414dc6c758b97b01ebbb202ccca9dcc21dedd407f69977501b6

signature

Linux64 Fedora Download (v4.16.1)
sha256sum - 1c211b474de3d6a6ffd85719b1edbea9ef01aabe202a85f32cfe4011473dda02

signature

Linux64 Other - AppImage (v4.16.1)
sha256sum - 0e262d2ba3a3815fcc52249419c477f8319b430cf15b021e51a7b2b4d8f2c093

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.16.1/bitbox_4.16.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