If the BitBoxApp fails to install on Windows, the issue is usually caused by an incomplete download, Windows security warnings, missing administrator permissions, another BitBoxApp process running in the background, or security software blocking the installer.
Complete the basic checks below, then use the troubleshooting section that matches the Windows message or behavior you see.
Before you begin
- Check whether your Windows version is supported. Unsupported or outdated Windows versions can prevent the BitBoxApp from installing or opening correctly. Check the supported operating systems for the BitBoxApp to confirm that your Windows version is supported.
- Update Windows. Install the latest Windows updates available for your computer. This helps ensure compatibility with the latest BitBoxApp version and allows Windows security features to work as expected.
- Restart your computer. Restarting Windows can resolve temporary launch issues, release files that are still in use, and complete pending update processes.
Troubleshooting
Download a fresh BitBoxApp installer
An incomplete or damaged download can prevent the BitBoxApp installer from opening or completing.
- Delete the BitBoxApp installer from your Downloads folder. Do not run it if it came from an unofficial source.
- Open the official BitBox download page.
- Download the latest Windows installer again.
- Open the new installer.
The BitBoxApp installer should now open normally and allow you to continue the installation.
Close existing BitBoxApp processes
Only one BitBoxApp instance should run at a time. If the BitBoxApp is still running in the background, the installer may not open correctly or may appear unresponsive.
- Close the BitBoxApp.
- Open Windows Task Manager.
- Check whether a BitBoxApp process is still running.
- End any remaining BitBoxApp process.
- Run the BitBoxApp installer again.
The installer should now open normally and continue with the installation.
Run the installer as administrator
Depending on your Windows configuration, administrator permissions may be required to install software. If you use a work, school, or otherwise managed computer, you may need approval from the device administrator.
- Locate the downloaded BitBoxApp installer.
- Right-click the installer.
- Select Run as administrator.
- Confirm the Windows permission prompt.
- Continue the installation.
Windows should now install the BitBoxApp successfully.
If Windows SmartScreen blocks the installer
Windows may display a SmartScreen warning such as Windows protected your PC.
This warning does not automatically mean that the BitBoxApp installer is unsafe. If you downloaded the BitBoxApp installer from the official BitBox download page, you can safely continue with the installation.
If you would like additional confirmation before bypassing the Windows SmartScreen warning, you can verify the BitBoxApp installer signature.
To continue with the installation:
- Select More info.
- Select Run anyway.
- Continue the installation.
The BitBoxApp installer should now open and allow you to continue the installation.
Check antivirus software or managed device policies
Microsoft Defender (Windows Defender), third-party antivirus software, endpoint protection tools, browser security settings, or company device policies can block the BitBoxApp download or installer.
- Check whether Microsoft Defender (Windows Defender) or another antivirus solution has quarantined or blocked the BitBoxApp installer.
- Check whether your browser blocked the downloaded installer.
- If you use a managed work or school computer, ask your device administrator whether software installation is restricted.
- Download the latest BitBoxApp installer again after the block is resolved.
- Run the installer again.
The BitBoxApp installer should now be allowed to run and the installation should complete.
If the BitBoxApp still shows an old version
Running the latest Windows installer normally updates the existing BitBoxApp installation. If the BitBoxApp still shows an older version, first verify which version is running before reinstalling.
- Close the BitBoxApp completely.
- Open the BitBoxApp again.
- Open Settings → About.
- Compare the displayed BitBoxApp version with the latest stable BitBoxApp release in the official GitHub repository.
- Only if the versions do not match, uninstall the BitBoxApp from Windows.
- Restart your computer.
- Download the latest Windows installer from the official BitBox download page.
- Install and open the BitBoxApp again.
- Open Settings → About and compare the displayed version again.
The version shown in Settings → About should match the latest stable BitBoxApp release published in the official BitBoxApp GitHub releases repository. If it does, you are running the latest installed version.
If your BitBox is not detected after installation
If the BitBoxApp opens but does not detect your BitBox, the installation itself is normally complete. Follow the steps to resolve BitBox detection problems on Windows.
Frequently asked questions
Why does nothing happen when I open the installer?
This can happen when another BitBoxApp process is still running in the background or when security software blocks the installer. Close any BitBoxApp processes in Task Manager and check whether Windows Security, your browser, or another security tool blocked the file.
Why does Windows say "Windows protected your PC"?
This warning is generated by Windows SmartScreen. If you downloaded the BitBoxApp installer from the official BitBox download page, you can safely continue with the installation. For additional confirmation, verify the BitBoxApp installer signature before selecting Run anyway.
Do I need administrator permissions to install the BitBoxApp on Windows?
Possibly. Depending on your Windows configuration, administrator permissions may be required to install the BitBoxApp. On managed work or school computers, your device administrator may need to approve the installation.
Can antivirus software prevent the BitBoxApp from installing?
Yes. Microsoft Defender (Windows Defender), third-party antivirus software, endpoint protection, browser security settings, or managed device policies can prevent the BitBoxApp installer from downloading, opening, or completing.
Can I update the BitBoxApp by installing the latest Windows version?
Yes. In most cases, running the latest Windows installer updates the existing BitBoxApp installation. To update or reinstall the BitBoxApp, follow the steps to install the BitBoxApp on Windows.
Will reinstalling the BitBoxApp remove my funds?
No. Reinstalling the BitBoxApp does not remove your funds. Your cryptocurrencies remain on their respective blockchain, while access to them is secured by your BitBox02 and your wallet backup.
Why does the BitBoxApp open but not detect my BitBox?
If the BitBoxApp opens but does not detect your BitBox, the installation itself is usually complete. Follow the steps to troubleshoot BitBox detection on Windows, including USB cables, Windows device detection, drivers, and BitBoxApp setup.
Does Windows on ARM support the BitBoxApp?
Windows on ARM is not recommended. The BitBoxApp may run through emulation, but this setup can cause slow performance, unresponsive behavior, or long loading times. Check the supported operating systems for the BitBoxApp before installing the BitBoxApp on Windows on ARM.
When should I contact BitBox support?
Contact BitBox Support through the official Support contact form if the installer still does not start, Windows continues to block it after you confirmed that it came from the official BitBox download page, the installation repeatedly stops, or the old version remains after reinstalling.
Include as much of the following information as possible:
- Your Windows version.
- Whether your computer is a personal device or a managed work or school device.
- The BitBoxApp version you attempted to install.
- The exact Windows security warning or installer error message.
- Any displayed error code.
- Whether the installer never opens or opens briefly and closes immediately.
- A screenshot of the warning or error, if possible.
- Whether antivirus software or endpoint protection is installed.
This information helps BitBox Support identify the cause more quickly.