Keeping the BitBoxApp up to date gives you the latest security improvements, compatibility updates, bug fixes, and features.
The update method depends on your operating system. On Windows, macOS, and most Linux installations, updating the BitBoxApp simply means installing the latest version over your existing installation. On Android, iPhone, and iPad, updates are normally managed by the app store.
Recovery words warning
Updating the BitBoxApp never requires your recovery words or your microSD backup.
Never enter your recovery words into the BitBoxApp, a website, a computer, or any other application during an update. If you are ever asked for your recovery words while updating the BitBoxApp, stop immediately. This is not part of the legitimate update process.
Check your BitBoxApp version
Before updating, check whether you are already running the latest stable BitBoxApp version:
- Open the BitBoxApp.
- Open Settings.
- Select About.
- Compare the displayed version with the latest stable BitBoxApp release in the official GitHub repository. If your installed version is older, continue with the update instructions below.
If the versions match, your BitBoxApp is up to date.
Update the BitBoxApp for your operating system
If you are unsure whether your operating system is supported, review the supported operating systems for the BitBoxApp before updating.
Windows
To update the BitBoxApp on Windows, download and run the latest Windows installer. In most cases, it updates the existing installation without requiring you to uninstall the previous version.
Follow the steps to install the latest BitBoxApp version on Windows.
macOS
To update the BitBoxApp on macOS, download the latest DMG and replace the existing BitBoxApp in the Applications folder.
Follow the steps to install the latest BitBoxApp version on macOS.
Linux
If you use a DEB or RPM package, installing the latest package normally updates the existing BitBoxApp installation. Follow the steps to install the latest BitBoxApp package on Linux.
The AppImage does not update automatically. Download the latest AppImage and replace the older file, then make the new file executable if necessary. Follow the steps to run the latest BitBoxApp AppImage on Linux.
Android
If you installed the BitBoxApp through Google Play, open the BitBoxApp listing in Google Play and select Update when a newer version is available. Follow the steps to install or update the BitBoxApp on Android.
Install the BitBoxApp on Android
If you installed the BitBoxApp without Google Play, follow the steps to update the BitBoxApp using the official Android APK.
iPhone and iPad
Open the BitBoxApp listing in Apple's App Store and select Update when a newer version is available. Follow the steps to install or update the BitBoxApp on iPhone and iPad.
If the BitBoxApp update fails
If the latest version cannot be installed or the BitBoxApp no longer opens after updating, use the troubleshooting instructions for your operating system:
- Follow the steps to resolve BitBoxApp installation and update problems on Windows.
- Follow the steps to resolve BitBoxApp installation and update problems on macOS.
- Follow the steps to resolve BitBoxApp installation and update problems on Linux.
BitBoxApp and BitBox firmware updates
Updating the BitBoxApp and updating the firmware on your BitBox are separate processes.
If a firmware update is available, the updated BitBoxApp will guide you through it after you connect and unlock your BitBox. For detailed instructions, follow the steps to update BitBox firmware.
Frequently asked questions
Will updating the BitBoxApp remove my funds or accounts?
No. Updating the BitBoxApp does not remove your funds. Your cryptocurrencies remain on their respective blockchains, while access is secured by your BitBox and wallet backup. Your BitBoxApp accounts, settings, and watch-only wallets normally remain available after the update.
Do I need to connect my BitBox to update the BitBoxApp?
No. You can update the BitBoxApp without connecting your BitBox. Connect and unlock your BitBox after the update when you want to access your wallet or install an available firmware update.
Do I need to uninstall the BitBoxApp before updating?
Usually not. On Windows, macOS, and supported Linux package installations, installing the latest version normally updates or replaces the existing BitBoxApp. The Linux AppImage is a standalone file and must be replaced manually.
Does the BitBoxApp update automatically?
On Android, iPhone, and iPad, the BitBoxApp may update automatically when automatic app updates are enabled. Desktop installations and the Linux AppImage currently require you to install or replace the app with the latest version.
What happens if I continue using an older BitBoxApp version?
An older BitBoxApp version may continue to work, but it may not include the latest security improvements, compatibility updates, bug fixes, or features. It may also become incompatible with newer BitBox firmware versions.
Can I skip BitBoxApp updates?
Yes, but it is not recommended. New BitBoxApp versions include security improvements, compatibility updates, bug fixes, and new features. Running the latest version also helps ensure compatibility with current BitBox firmware and supported operating systems.
Does updating the BitBoxApp also update BitBox firmware?
No. Updating the BitBoxApp does not update your BitBox firmware automatically.
After updating the BitBoxApp, connect and unlock your BitBox. If a newer firmware version is available, the BitBoxApp will offer the firmware update separately. Follow the steps to update BitBox firmware.