How to fix a BitBox not recognized via USB

Table of Contents

Before you start Quick checks Check the most common software causes Check whether your operating system detects your BitBox macOS Windows Linux BitBox02 Nova and iOS Still having problems? FAQ – Frequently asked questions Is my BitBox defective if it is not recognized? Why does my computer detect my BitBox, but the BitBoxApp does not? Can I lose my coins because of a USB connection issue? What does it mean if my BitBox works on another device? I see “Unexpected error. Please contact support.” What should I do? Which guide should I follow? When should I contact support?

If your BitBox is not connecting to your computer or is not detected by the BitBoxApp, the issue is usually related to the USB cable, USB port, operating system, security software, or BitBoxApp setup.

This guide helps you complete the most important general checks first. If the issue is specific to your operating system, you can then continue with the dedicated macOS, Windows, or Linux guide.

This article applies to BitBox hardware wallets connected via USB, including BitBox02 and BitBox02 Nova.

Before you start

Before troubleshooting your USB connection, make sure that:

you are using the latest version of the BitBoxApp, and
the firmware on your BitBox is up to date.

Outdated BitBoxApp or firmware versions can prevent your BitBox from being detected correctly, even if the USB connection itself works.

Quick checks

Start with these basic checks. They resolve many USB connection issues.

Try a different USB cable.
Connect your BitBox directly to your computer.
Avoid USB hubs, docking stations, adapters, or extension cables during troubleshooting.
Try a different USB port.
Connect your BitBox so that the screen is facing up.
Restart your computer.
Test your BitBox on another computer or Android smartphone, if possible.

If your BitBox works on another device, the BitBox itself is most likely working correctly. The issue is probably related to your original computer, USB port, adapter, operating system, or software setup.

Check the most common software causes

If the quick checks did not help, continue with these general software checks.

Close the BitBoxApp.
Disconnect your BitBox.
Restart your computer.
Open the BitBoxApp again.
Reconnect your BitBox.
Temporarily disable antivirus software, firewall tools, VPN tools, or endpoint security software for testing.
Re-enable your security software immediately after testing.
If disabling security software helps, add the BitBoxApp to the allowed list.
Download and reinstall the latest version of the BitBoxApp.

Only disable security software temporarily for testing. Re-enable it immediately afterward. If it blocks the BitBoxApp, add the BitBoxApp to the allowed list instead of keeping protection disabled.

Check whether your operating system detects your BitBox

Even if the BitBoxApp does not show your BitBox, your operating system may already recognize it as a connected USB device.

This distinction is important:

If your operating system does not detect your BitBox, the issue is likely related to the USB cable, USB port, adapter, or physical connection.
If your operating system does detect your BitBox, but the BitBoxApp does not, the issue is more likely related to permissions, drivers, the BitBoxApp installation, or blocking software.

Choose your operating system below and continue with the dedicated guide.

macOS

If you use macOS, check whether your Mac detects your BitBox in System Information or through the Terminal app.

Continue here:
How to fix a BitBox not recognized on macOS

Windows

If you use Windows, check whether your BitBox appears in Device Manager and whether the hardware IDs match the BitBox USB device.

Continue here:
How to fix a BitBox not recognized on Windows

Linux

If you use Linux, check whether your BitBox appears with lsusb. If Linux detects your BitBox but the BitBoxApp does not, the issue is usually related to missing udev rules or USB permissions.

Continue here:
How to fix a BitBox not recognized on Linux

Linux users should follow the dedicated Linux guide. Linux USB permission issues are more technical and are explained separately to keep this general guide easier to follow.

BitBox02 Nova and iOS

This article focuses on USB connection issues on desktop operating systems.

If you use a BitBox02 Nova with iOS and experience Bluetooth-related issues, follow this guide instead:
Troubleshooting BitBox02 Nova Bluetooth issues on iOS

Still having problems?

If your BitBox is still not recognized after completing the general checks and the dedicated guide for your operating system, our support team will be happy to help.

Please include the following information:

your computer model,
your operating system and version,
the BitBoxApp version you are using,
which BitBox device you use,
what you have already tried,
whether your operating system detects your BitBox,
and your BitBoxApp log files.

You can follow this guide to export the required files:
How to locate and export BitBoxApp support files

Then contact support and include the information above.

If you reached this point, you have already completed the standard troubleshooting steps. This information helps support investigate the issue more specifically.

FAQ – Frequently asked questions

Is my BitBox defective if it is not recognized?

In most cases, no. USB connection issues are usually caused by cables, USB ports, adapters, drivers, permissions, security software, or operating system settings.

Why does my computer detect my BitBox, but the BitBoxApp does not?

If your operating system detects your BitBox but the BitBoxApp does not, the issue is usually related to the BitBoxApp installation, missing permissions, drivers, or software that blocks USB communication.

Can I lose my coins because of a USB connection issue?

No. Your coins are not stored on your BitBox. They are recorded on the blockchain. As long as your recovery words are safely backed up, your funds are not at risk because of a USB connection issue.

What does it mean if my BitBox works on another device?

This usually means that your BitBox itself is working correctly. The issue is most likely related to your original computer, USB port, adapter, operating system, drivers, or software setup.

I see “Unexpected error. Please contact support.” What should I do?

This message is often caused by a connection issue between your BitBox and your device.

First, follow the quick checks in this article. Then continue with the dedicated guide for your operating system. If the issue persists, contact support and include your BitBoxApp log files.

Which guide should I follow?

Follow the guide for the operating system where the issue occurs:

When should I contact support?

Contact support if you have tried different cables, ports, and devices, followed the dedicated guide for your operating system, and your BitBox is still not recognized.