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:
USB
Bluetooth
USB: General Checks
Before trying steps specific to your operating system, it may help to review the following if your computer is having issues recognizing Jade:
- Restart the Blockstream app and reboot Jade: Close the app and reboot your Jade to establish a new connection.
- 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.
- Connect Jade to an alternate companion app: Pairing Jade with a different application, such as Sparrow, can help to determine if the issue is with your software or with Jade.
- Try a different USB cable: Certain USB cables may not allow data transfer and thus prevent your device from detected Jade.
- Avoid using USB adapters: Most adapters should work fine, however a low-quality accessory may also cause issues with Jade being detected.
- Plug into a different USB port: Your computer may have a defective USB port or one that is only used for charging.
- 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.
USB: 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.
- Download this driver and navigate to the CH34XSER_MAC folder found in your downloads once completed.
- Open the folder and double-click CH34xVCPDriver.pkg.
- 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.
- 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.
- Download the CP210x VCP Mac OSX Driver and navigate to the macOS_VCP_Driver folder found in your downloads once completed.
- Open the folder and double-click SiLabsUSBDriverDisk.dmg, then select Install CP210x VCP Driver.
- 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.
- Unplug Jade and reboot your machine for the changes to take effect.
USB: 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.
- Download this driver and select the folder found in your downloads folder once completed.
- Click Extract all near the top of the File Explorer window while in the driver folder and choose Setup.exe to install the driver.
- 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.
- Download the CP210x Universal Windows Driver and select the folder found in your downloads once completed.
- Click Extract all near the top of the File Explorer window while in the CP210X_Universal_Windows_Driver folder.
- Once extracted, check the box next to the silabser file with the Setup Information type, right-click and select Install from the drop-down.
- 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.
- Unplug Jade and reboot your machine for the changes to take effect.
USB: 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.
- 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
- 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.
Create a custom udev rule: /etc/udev/rules.d/21-jade.rules
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
- Unplug Jade and reboot your machine for the changes to take effect.
Bluetooth: iOS and Android
Jade is compatible with iOS and Android devices using Bluetooth. However, a poor pairing can sometimes cause connectivity issues with your companion device.
Note: Jade is a self-custodial signing device. Blockstream support cannot access, reset, or recover your recovery phrase, PIN, or funds, and cannot sign transactions for you. Keep your recovery phrase private. Anyone who has it can move your bitcoin.
If the troubleshooting steps below do not resolve your issue, it may help to factory reset Jade, reboot your phone, or try pairing on another device to rule out mobile-specific errors.
Connection Timeout or Pairing Error
Completely resetting all pairing information is often effective in resolving timeout or pairing issues.
- In your phone's system settings, forget the Jade device from the Bluetooth list. Then, reboot both your phone and the Jade device. Try to pair again using the Blockstream App. If unsuccessful after a few attempts, continue with the steps below.
- On Jade, try Reset Pairings.
- Uninitialized Jade: Navigate to Options → Settings → Bluetooth → Reset Pairings.
- Initialized Jade: Access a session via USB or QR login, then navigate to Options → Settings → Bluetooth → Reset Pairings.
- In the Blockstream app, go to App Settings and disable Tor or other custom network configurations. Then, force close the app completely.
- Retry pairing. When the pairing codes appear on both Jade and your phone, confirm the code on Jade first, then on your phone.
Jade Not Recognized
If Jade is not appearing in the Bluetooth list or connection attempts fail, follow these steps:
- Confirm that Bluetooth is enabled on Jade:
- Uninitialized Jade: Navigate to Options → Settings → Bluetooth → Status: Enabled.
- Initialized Jade: Log in via USB or QR, then go to Options → Device → Settings → Bluetooth → Status: Enabled
- Ensure you are running a firmware version that supports Bluetooth. If unsure, update to a radio-enabled firmware using the Upgrade Web Portal.
- On your mobile phone, check the system-level settings for the Blockstream app:
- Ensure Bluetooth permissions are enabled.
- Disable Do Not Disturb on your phone, as it may block permission prompts.
For Android 11 or earlier: Enable location services for the Blockstream app.
Note: This is a platform requirement—the Blockstream app does not use or store your location.
Bluetooth: macOS, Windows, and Linux
Jade also pairs over Bluetooth with the Blockstream app on macOS, Windows, and Linux.
Jade Cannot Reconnect After Reset Pairings
If you used Reset Pairings on Jade, the Blockstream app may list Jade but fail to connect, because your computer still holds the old pairing.
- Open the Bluetooth settings on your computer.
- Find Jade in the list of paired devices and select Forget Device (or remove it from the list).
- Return to the Blockstream app and connect Jade again.
macOS Pairing Dialog Does Not Appear
If Jade shows a pairing code but your Mac never shows a pairing dialog, or nothing happens on your Mac when you try to pair, a macOS background service may be stuck. This has been seen on macOS Sequoia.
- Quit the Blockstream app.
- Restart your Mac.
- Reopen the Blockstream app and pair Jade again.
- Confirm that the code shown by macOS matches the code shown on Jade.
If the pairing dialog still does not appear, reset the stuck service from Terminal:
- Quit the Blockstream app.
- Open Terminal and run
killall searchpartyuseragent - Reopen the Blockstream app and pair Jade again.
macOS restarts this service automatically. The command does not change your wallet or your Jade.
Signing Issues
Use these steps when Jade is connected but a transaction will not sign.
- Confirm the app and Jade are unlocked to the same wallet. A transaction created on one wallet cannot be signed by a different wallet or recovery phrase.
- Confirm both devices are set to the same network, Bitcoin or Liquid. A Liquid transaction will not sign on a Jade set to Bitcoin.
- When the transaction details appear on Jade, review them on the device screen and select to approve. Always verify the amount and address on Jade itself, not only in the app.
- If the transaction never appears on Jade, the connection dropped mid-session. Reconnect Jade, reopen the wallet in the app, and create the transaction again.
- Make sure Jade's firmware is current. Update through the Upgrade Web Portal if a newer version is available.
Still Need Help?
The fastest way to reach support is from inside the app, because the report includes your logs. Open the app, go to the Settings tab, tap Support, enter your email and a short description of the issue, keep Share Logs checked, and tap Submit. See Submit log data for troubleshooting.
If these steps do not resolve the issue, you can also submit a request on the Help Center. Include the Jade model and firmware version, the Blockstream app version, your phone or computer model and operating system version, the connection method (Bluetooth or USB), and the exact wording of any error message (a screenshot helps).
Do not include your recovery phrase, PIN, or any 2FA codes. Support will never ask for them.