This article explains which operating systems and device types are compatible with the BitBoxApp and the BitBox02 hardware wallet, and where to download the official application and firmware releases.
Download the BitBoxApp from the official website:
bitbox.swiss/app
The download page automatically provides the correct version for your operating system. For security reasons, always avoid third-party download websites.
For security reasons, always avoid third-party download websites.
Supported desktop operating systems
The BitBoxApp supports the following 64-bit desktop operating systems.
| Operating System | Minimum Version |
| Windows | 10 |
| macOS | 12 |
| Debian | 11.6 |
| Ubuntu | 22.04 |
| Fedora | 36 |
| openSUSE | Rolling release |
The BitBoxApp supports 64-bit operating systems only.
If you are using an older 32-bit system, the BitBoxApp cannot be installed or executed.
Supported mobile operating systems
You can use the BitBoxApp on supported mobile platforms as outlined below.
| Platform | Supported devices | Minimum OS version | Requirements / Notes |
|---|---|---|---|
| Android | Android smartphones and tablets | Android 9 | Device must support USB OTG (On-The-Go) to connect the BitBox02. See: What is USB OTG / USB Host Mode on Android? How do I know if my phone supports it? |
| iOS | iPhone and iPad | iOS 16 | Compatible only with the BitBox02 Nova edition. See: How to use the BitBoxApp on iOS with the BitBox02 Nova. |
Android WebView troubleshooting
On Android devices, the BitBoxApp relies on Android System WebView to render certain internal web content.
If this component is outdated, the app may not display some screens correctly.
You can check this in:
Settings → Apps → Android System WebView
Make sure it is updated through the Google Play Store.
Huawei phones or missing WebView cases
On some devices, especially certain Huawei phones, Android System WebView may not be visible in the normal app list.
If you cannot find it there, the following workaround may help:
- Download Google WebView Canary from the Play Store.
- Open your phone’s Developer options.
- Go to WebView implementation.
- Switch the system WebView to Google WebView Canary.
Only apply this workaround if Android System WebView is missing or outdated.
Unsupported or not recommended environments
The following environments are not supported or are not recommended for reliable use with the BitBoxApp.
Chromebooks
Chromebooks are not supported.
Although some Chromebooks can run Linux applications, they typically do not provide the required USB device communication for the BitBox02.
More information:
Set up the Linux development environment
Raspberry Pi OS
Raspberry Pi OS is not supported.
Despite being Linux-based, the system architecture and USB communication do not meet the requirements for reliable BitBox02 operation.
Windows on ARM
Windows on ARM is not officially supported.
While the BitBoxApp may run via emulation, this setup can result in:
- Very slow performance
- Noticeable lag and unresponsive behavior
- Long loading times
- Unreliable overall user experience
For stable use, run the BitBoxApp on a supported x86-64 desktop operating system such as Windows, macOS, or Linux.
Downloads, releases, and verification
To ensure authenticity and security, always download the BitBoxApp and firmware only from our official sources.
Use these official sources:
Version compatibility between BitBoxApp and BitBox02 firmware
The BitBox02 firmware is distributed through the BitBoxApp.
Because of this, firmware updates depend on the version of the BitBoxApp you are using.
When a new firmware version becomes available, you must first update the BitBoxApp.
Only the latest BitBoxApp version can install and communicate with the newest firmware.
Typical update flow:
- Update the BitBoxApp to the latest version.
- Connect your BitBox02.
- The BitBoxApp will detect that a new firmware version is available.
- Follow the prompts in the app to install the firmware update.
If you are using an older BitBoxApp version, it may not recognize or support the latest firmware.
For detailed instructions on updating the device firmware, see:
How to update the BitBox02 firmware
BitBoxApp releases
The BitBoxApp is open-source. The GitHub repository provides:
- the latest stable version
- previous versions
- release notes and changes
Official BitBoxApp repository:
Avoid versions marked Pre-release unless you intentionally want to test upcoming features.
BitBox02 firmware releases
Firmware updates are also published openly on GitHub:
BitBoxSwiss / bitbox02-firmware
There you can review:
For the best compatibility and security, always keep both the BitBoxApp and the device firmware up to date.
FAQ – Downloads, versions, and compatibility
Where can I see the latest BitBoxApp version?
The latest stable version is available at:
bitbox.swiss/app
or on the official GitHub releases page:
Where can I find BitBox02 firmware updates and release notes?
All firmware releases and changelogs are available here:
BitBoxSwiss / bitbox02-firmware
Is it safe to download older versions of the BitBoxApp?
Older versions remain available for transparency and troubleshooting.
However, they may lack security updates or bug fixes, so using the latest stable version is strongly recommended.
Can I download the BitBoxApp from third-party websites?
No.
Only download the BitBoxApp from official sources.
Third-party websites may provide outdated or modified files.
Why does the BitBoxApp not load correctly on my Android device?
In some cases, this can be caused by an outdated Android System WebView.
Check that Android System WebView is installed and updated in your device settings.
If it is missing (for example on some Huawei devices), installing Google WebView Canary and selecting it in Developer options → WebView implementation may resolve the issue.