# Fix issues connecting Jade via USB

Source URL: https://helpcenter.dxp-frontend.devserver.app/blockstream-jade/troubleshooting/fix-issues-connecting-jade-via-usb
Updated: 2026-04-09T09:37:16.000Z
Category: Blockstream Jade
Section: Troubleshooting

---

Jade is compatible with many different platforms, however each may require additional configurations to allow Jade to connect and communicate with your companion app device properly. Below are some recommended steps to assist in connecting Jade to each supported platform:

- [MacOS](#h%5F01H4PFV1R8CC9TCSBBMBTP5E6J)
- [Windows](#h%5F01H4PFV7293FFKPKFVETX1FPH1)
- [Linux](#h%5F01H4PFVDM5QE2GE7E9KA5VQ2XX)

Before trying steps specific to your operating system, it may help to review the following if **your computer is having issues recognizing Jade**:

1. **Restart the Blockstream app and reboot Jade**: Close the app and reboot your Jade to establish a new connection.
2. **Update your operating system to the latest version**: Jade may not be recognized on operating systems (OS) that are outdated or have reached their end-of-life (no longer supported by the vendor), so we recommend updating your computer's OS.
3. **Connect Jade to an alternate companion app**: Pairing Jade with a [different application](https://helpcenter.dxp-frontend.devserver.app/blockstream-jade/set-up-transact-recover-your-wallet/download-a-companion-app-for-jade), such as Sparrow, can help to determine if the issue is with your software or with Jade.
4. **Try a different USB cable**: Certain USB cables may not allow data transfer and thus prevent your device from detected Jade.
5. **Avoid using USB adapters**: Most adapters should work fine, however a low-quality accessory may also cause issues with Jade being detected.
6. **Plug into a different USB port**: Your computer may have a defective USB port or one that is only used for charging.
7. **Close all applications on your computer and restart your system**: You may have an application open that is trying to communicate with Jade and thus blocking the port from being used by your intended app.

## MacOS

### Option #1: Jade Not Recognized, Receiving Error Messages, or Upgrade Issues

If Jade is not recognized or you are experiencing error messages on your Jade or companion app while your device is connected, you may need to install an additional driver.

1. Download [this driver](https://greenupdate.blockstream.com/desktop/drivers/CH34XSER%5FMAC.ZIP) and navigate to the CH34XSER\_MAC folder found in your downloads once completed.
2. Open the folder and double-click **CH34xVCPDriver.pkg**.
3. Continue through the installation helper until you see the Success message. If you encounter a "System Extension Blocked" error, choose to **Open System Settings** and select **Allow** under the prompt that shows that **CH34xVCPDriver** was blocked from loading.
4. Reboot Jade and try again. If you are still having issues, you may need to reboot your computer for the changes to take effect.

### Option #2: If Jade is Still Not Recognized

If Jade is still not recognized by your computer, you may need to install a relevant driver.

1. Download the [CP210x VCP Mac OSX Driver](https://www.silabs.com/documents/public/software/Mac%5FOSX%5FVCP%5FDriver.zip) and navigate to the **macOS\_VCP\_Driver** folder found in your downloads once completed.
2. Open the folder and double-click **SiLabsUSBDriverDisk.dmg**, then select I**nstall CP210x VCP Driver**.
3. Continue through the installation helper until you see the Success message. If you encounter a "System Extension Blocked" error, choose to **Open System Settings** and select **Allow** under the prompt that shows that CP210xVCPDriver was blocked from loading.
4. Unplug Jade and reboot your machine for the changes to take effect.

## Windows

### Option #1: Jade Not Recognized or Upgrade Issues

If Jade is not recognized by your computer, you may need to install a relevant driver.

1. Download [this driver](https://www.wch-ic.com/download/file?id=330) and select thefolder found in your downloads folder once completed.
2. Click **Extract all** near the top of the File Explorer window while in the driver folder and choose **Setup.exe** to install the driver.
3. Unplug Jade and reboot your machine for the changes to take effect.

### Option #2: If Jade is Still Not Recognized

If Jade is not recognized by your computer, you may need to install a separate relevant driver.

1. Download the [CP210x Universal Windows Driver](https://www.silabs.com/documents/public/software/CP210x%5FUniversal%5FWindows%5FDriver.zip) and select thefolder found in your downloads once completed.
2. Click **Extract all** near the top of the File Explorer window while in the **CP210X\_Universal\_Windows\_Driver** folder.
3. Once extracted, check the box next to the **silabser** file with the **Setup Information** type, right-click and select **Install** from the drop-down.
4. Choose **Open** and continue through the installation by allowing the driver to make changes to your device. You will then see a message that the driver was installed successfully.
5. Unplug Jade and reboot your machine for the changes to take effect.

## Linux

### Option #1: Jade Not Recognized

If Jade is not recognized by your computer, you may need to add your user to the appropriate group.

1. Add your user to the **dialout**, **plugdev**, or **uucp** group using the following commands:  
    
`sudo adduser yourusername dialout` or  
`sudo usermod -a -G dialout yourusername`  
    
`sudo adduser yourusername plugdev` or  
`sudo usermod -a -G plugdev yourusername`  
    
`sudo adduser yourusername uucp` or  
`sudo usermod -a -G uucp yourusername`
2. Unplug Jade and reboot your machine for the changes to take effect.

### Option #2: Error Messages when Using Jade

If you are experiencing error messages on your Jade, this may be due to a known bug caused by Linux distributions related to auto-suspend.

1. Create a custom udev rule: **/etc/udev/rules.d/21-jade.rules**  
```auto  
ATTRS{idProduct}=="55d4",  
ATTRS{idVendor}=="1a86",  
SUBSYSTEM=="usb",  
TEST=="power/control",  
ATTR{power/control}="on",  
GROUP="plugdev",  
MODE="0660"  
```  
And then run:  
`udevadm control --reload-rules && udevadm trigger`
2. Unplug Jade and reboot your machine for the changes to take effect.

Navigation: Blockstream Help Center > Blockstream Jade > Fix issues connecting Jade via USB

## Related Articles in This Section
- [Fix issues upgrading Jade](https://helpcenter.dxp-frontend.devserver.app/blockstream-jade/troubleshooting/fix-issues-upgrading-jade)
- [Fix issues connecting Jade via USB](https://helpcenter.dxp-frontend.devserver.app/blockstream-jade/troubleshooting/fix-issues-connecting-jade-via-usb) (current)
- [Fix issues pairing Jade via Bluetooth](https://helpcenter.dxp-frontend.devserver.app/blockstream-jade/troubleshooting/fix-issues-pairing-jade-via-bluetooth)
- [Fix issues scanning QR codes](https://helpcenter.dxp-frontend.devserver.app/blockstream-jade/troubleshooting/fix-issues-scanning-qr-codes)
- [Perform a factory reset](https://helpcenter.dxp-frontend.devserver.app/blockstream-jade/troubleshooting/perform-a-factory-reset)
