Only follow this guide if your BitBox01 is already reset to factory state.
If you are experiencing 2FA issues, please order a support replacement BitBox01 and restore your wallet on that replacement instead of resetting your current BitBox01 to factory state.
Before you start, ensure the following:
- You have a BitBox01, if you need one you can order a support replacement here.
- You have your microSD card which contains your wallet backup file.
- You know your backup recovery password.
- You are using the latest BitBoxApp, currently version 4.27.0 (on the 4th of May 2021).
- You are using the latest BitBox01 firmware, currently version 7.1.0 (on the 4th of May 2021).
Troubleshooting: BitBox01 not detected
If your BitBox01 has not been updated in a long time the latest BitBoxApp will not detect it. In that case you need to install version 3.0.0 of the old DigitalBitBoxApp and upgrade your BitBox01 firmware with that app. Once done, quit the DigitalBitBoxApp and launch the latest BitBoxApp again. The latest BitBoxApp will then detect your BitBox01.
Troubleshooting: BitBox01 passwords
- Since roughly August 2018 you had to choose at least two passwords (more if you were using hidden wallets) when setting up your BitBox01. One called the "device password" is needed each time you access your BitBox01 wallet, the other, called "backup recovery password" protects your wallet backup from unauthorised access and is needed when you want to restore your wallet from your microSD card backup.
- Before August 2018 (or if you were using the old DigitalBitBox App, not "BitBoxApp") the device & recovery password are identical.
Restore standard wallet
In order to restore your standard wallet (not hidden & not legacy hidden wallet) follow these steps:
- Plug microSD card into BitBox01
- Plug BitBox01 into BitBoxApp.
- Select “Restore from a backup” & continue.
- Set a device password, this can be anything.
- Select your wallet backup file that you want to restore, then click “Restore”.
- Enter your recovery password. This password needs to be 100% identical to the recovery password you were using in the past. Then tick the checkbox and click “Restore”
- Your standard wallet is now restored.
Attention: There will be no error if you input a different backup recovery password than the one you used when you created your wallet. The BitBox01 does not store information about your recovery password and therefore can’t “check” if it is the same one you used before or not. If you created your wallet before Aug 2018, then your backup recovery password is most likely identical to your normal device password.
Troubleshooting:
Help, my restored wallet is empty!
- Check all 3x Bitcoin accounts in the BitBoxApp (Bitcoin, Bitcoin Legacy, Bitcoin bech32)
- If all 3x Accounts are empty:
- Either you entered a different recovery password (not identical to the one used in the past). ⇒ Try restoring again, this time with the correct recovery password.
- Your microSD card contains multiple backup files that are not duplicates but different wallets (this can happen if you reset your BitBox01 in the past and instead of restoring your wallet you created a new wallet). ⇒ Try restoring from the other wallet backup files.
Restore hidden wallet (not legacy hidden)
Before you can restore your hidden wallet, first restore your standard wallet (see above). Only once you have successfully restored your standard wallet can you restore your hidden wallet. To confirm that you have successfully restored your standard wallet check if the transaction history matches your expectations (or compare the xPubs if you had noted them down).
- Unlock your standard wallet.
- Go to “Manage Device”.
- Click “Create hidden wallet”.
- Enter any hidden wallet device password that you want to use to access your hidden wallet.
- Enter the 100% identical hidden wallet password that you used when you created your hidden wallet.
- Confirm that you want to create a hidden wallet by performing a long touch on your BitBox01.
- Unplug your BitBox01, then use the hidden wallet device password (see step 4) to access the hidden wallet.
- In order to make transactions from a hidden wallet, your BitBox01 needs to be paired to a smartphone. If your BitBox01 is not paired, see at the bottom of this page.
Restore legacy hidden wallet
Before you can restore your legacy hidden wallet, first restore your standard wallet (see above). Only once you have successfully restored your standard wallet can you restore your legacy hidden wallet. To confirm that you have successfully restored your standard wallet check if the transaction history matches your expectations (or compare the xPubs if you had noted them down).
- First follow the steps above to create a hidden wallet.
- Unlock your standard wallet.
- Go to “Manage Device”.
- Open the in-App guide by clicking on “Guide” in the upper right corner.
- Click “How do I access the legacy hidden wallet?” then click “Enable legacy hidden wallet” to instruct your BitBox01 to unlock the legacy hidden wallet (instead of default hidden wallet) when you enter your hidden wallet device password.
- Unplug your BitBox01, then use the hidden wallet device password to access the legacy hidden wallet.
- In order to make transactions from a legacy hidden wallet, your BitBox01 needs to be paired to a smartphone. If your BitBox01 is not paired, see at the bottom of this page.