Applies to JuBiter Wallet Desktop 2.0.1 · JuBiter Blade and compatible JuBiter devices
Overview
JuBiter Wallet Desktop is the companion application for your JuBiter hardware wallet on personal computers. It lets you manage accounts, check balances, receive and send cryptocurrency, and keep your device firmware up to date — while your private keys stay inside the device's certified secure element at all times.
The application never has access to your private keys or recovery phrase. Every transaction is prepared on the computer, sent to the device, displayed on its screen for your review, and signed only after you physically confirm it with the OK button.
How this guide is organised
System Requirements
| Platform | Minimum version | Package |
|---|---|---|
| Windows | Windows 10 (64-bit) or later | Jubiter-2.0.1.exe |
| macOS | macOS 11 Big Sur or later (Intel & Apple silicon) | Jubiter-2.0.1.dmg |
| Linux | Ubuntu 20.04, Debian 11, Fedora 36 or equivalent (64-bit) | .AppImage or .deb |
- 4 GB RAM and 300 MB of free disk space.
- A free USB port (USB-A or USB-C with adapter) and a data-capable Micro USB cable.
- An internet connection for balances, broadcasting transactions and updates.
- Optional: Bluetooth 4.0+ for wireless connection where supported by your computer.
Installing on Windows (.exe)
- 1Download
Jubiter-2.0.1.exefrom the official Download page only. - 2Verify the file checksum (see Verifying Downloads) before running it.
- 3Double-click the installer. If Windows SmartScreen appears, confirm the publisher is the official JuBiter signer and choose Run.
- 4Choose the installation folder (default: C:\Program Files\JuBiter Wallet) and click Install.
- 5Launch JuBiter Wallet from the Start menu or desktop shortcut.
USB drivers
Installing on macOS (.dmg)
- 1Download
Jubiter-2.0.1.dmgfrom the official Download page. - 2Open the disk image and drag the JuBiter Wallet icon into the Applications folder.
- 3Eject the disk image, then open JuBiter Wallet from Applications or Launchpad.
- 4On first launch macOS confirms the app is notarized; click Open.
- 5If prompted, allow Bluetooth access in System Settings → Privacy & Security.
Installing on Linux (.AppImage / .deb)
AppImage — portable, works on most distributions:
chmod +x Jubiter-2.0.1.AppImage ./Jubiter-2.0.1.AppImage
Debian / Ubuntu package:
sudo apt install ./Jubiter-2.0.1.deb
To let your user access the device without root, add a udev rule and reconnect the device:
echo 'KERNEL=="hidraw*", ATTRS{idVendor}=="096e", MODE="0660", TAG+="uaccess"' \
| sudo tee /etc/udev/rules.d/51-jubiter.rules
sudo udevadm control --reload-rules && sudo udevadm triggerVerifying Downloads
Always confirm the installer has not been tampered with. Compare its SHA-256 hash with the value published on the Download page.
| System | Command |
|---|---|
| Windows (PowerShell) | Get-FileHash .\Jubiter-2.0.1.exe -Algorithm SHA256 |
| macOS | shasum -a 256 Jubiter-2.0.1.dmg |
| Linux | sha256sum Jubiter-2.0.1.AppImage |
If the hash does not match
Updating the App
The application checks for new versions at startup and shows a banner when an update is available. Updates are cryptographically signed and verified before installation. You can also check manually under Settings → About → Check for updates. Linux AppImage users replace the old file with the new one.
First-time Setup
- 1Charge the device and turn it on by holding the C (power) button.
- 2Open JuBiter Wallet Desktop and select Get Started.
- 3On the device, choose Create Wallet for a new wallet, or Restore Wallet if you already have a recovery phrase.
- 4Set a PIN directly on the device using the Up / Down and OK buttons.
- 5Choose a 12, 18 or 24-word recovery phrase, write every word on the recovery sheet in order, then confirm the words on the device.
- 6The app detects the initialised device and offers to add your first accounts.
Offline by design
Connecting Your Device
USB: connect the device with the Micro USB cable and unlock it with your PIN. The status bar in the app shows Device connected.
Bluetooth: open Settings → Devices → Pair new device, turn on Bluetooth on the JuBiter device, and confirm that the pairing code is identical on both screens.
The app automatically locks the session when the device is disconnected or after the inactivity timeout.
Managing Accounts
Accounts are derived from your recovery phrase using the BIP32 / BIP44 standards, so the same accounts reappear after recovery on any compatible device.
- Add account: Accounts → Add account → choose the asset. The device confirms the derivation.
- Rename / hide: right-click an account to rename it or hide it from the dashboard.
- Tokens: ERC-20 and TRC-20 tokens are shown under their parent Ethereum or TRON account.
- Portfolio: the dashboard displays total value in your chosen currency, updated in real time.
Receiving Funds
- 1Select the account and click Receive.
- 2Click Verify on device. The address appears on the JuBiter screen.
- 3Make sure the address on the device matches the one in the app, character by character.
- 4Copy the address or show the QR code to the sender.
Always verify on the device
Sending Funds
- 1Select the account and click Send.
- 2Paste or scan the recipient address and enter the amount.
- 3Choose a fee level (see Network Fees) and click Continue.
- 4Review the amount, fee and address on the device OLED display.
- 5Press OK on the device to sign, or Cancel to reject. The app then broadcasts the signed transaction.
Network Fees
| Level | Typical use |
|---|---|
| Slow | Lowest cost; confirmation may take longer during busy periods. |
| Standard | Recommended balance between cost and speed. |
| Fast | Highest priority for time-sensitive transfers. |
| Custom | Advanced users can set sat/vB or Gas price & limit manually. |
Transaction History
Each account lists incoming and outgoing transactions with status (pending, confirmed, failed), date, amount and fee. Click a transaction to view it in a block explorer. History can be exported to CSV under Accounts → Export for accounting.
Security Model
| Secure element | Infineon chip certified Common Criteria EAL6+ stores and uses private keys. |
| Operating system | Java Card OS certified CC EAL5+. |
| Key isolation | Private keys and recovery phrase never leave the device. |
| Transaction review | All details shown on the device screen; physical confirmation required. |
| App data | Stored locally and encrypted; contains only public keys and labels. |
PIN & Passphrase
The PIN protects the device against physical access. After several consecutive wrong entries the device wipes itself to protect your funds — they can then be restored with the recovery phrase. An optional passphrase (sometimes called a 25th word) creates a separate hidden wallet; losing it means losing access to that wallet.
Backup & Recovery
Your recovery phrase follows BIP39 and can restore your funds on a new JuBiter device or any compatible wallet.
- Keep the written phrase offline, in a secure and private place.
- Never type it into a computer, phone, website or cloud document.
- JuBiter support will never ask for your recovery phrase or PIN.
To recover: on a new or reset device choose Restore Wallet, enter the words on the device, set a new PIN, then reconnect to the app to rediscover your accounts.
Firmware Updates
When new firmware is available, the app shows a notification in Settings → Device. Keep the device connected by USB with a charged battery, start the update and confirm on the device. Firmware is signed by the manufacturer and verified by the device before installation. Your accounts and funds are not affected; have your recovery phrase available as a precaution.
Application Settings
| Setting | Description |
|---|---|
| Display currency | USD, EUR, GBP and other fiat currencies for portfolio value. |
| Language | Interface language of the desktop application. |
| Auto-lock | Locks the app after a chosen period of inactivity. |
| App password | Optional password required to open the app on this computer. |
| Custom node | Connect to your own Bitcoin or Ethereum node for extra privacy. |
| Clear cache | Resets locally cached data; accounts are rediscovered from the device. |
Supported Assets
Bitcoin (BTC), Ethereum (ETH) and ERC-20 tokens, Bitcoin Cash (BCH), Litecoin (LTC), Ethereum Classic (ETC), Tether (USDT), Dash (DASH), Ripple (XRP), EOS and TRON (TRX). Support for additional assets is added through app and firmware updates.
Device Specifications
| Dimensions | 64 × 38 × 2.3 mm |
| Display | 0.96″ 128 × 64 monochrome OLED |
| Buttons | Up, Down, OK, Cancel/Power |
| Interfaces | Micro USB (HID), Bluetooth 4.1 |
| Secure element | Infineon, CC EAL6+ |
| Casing | Zinc alloy |
| Battery | 33 mAh rechargeable |
| Certifications | CE, FCC, FIDO U2F, RoHS |
Troubleshooting
| Problem | Solution |
|---|---|
| Device not detected | Use a data cable, try another USB port, unlock the device, restart the app. On Linux, check the udev rule. |
| Bluetooth pairing fails | Remove the old pairing from system settings and the app, then pair again. |
| Balance shows zero | Check your internet connection, then use Settings → Clear cache to resync. |
| Transaction pending | The fee may be too low; wait or use replace-by-fee where supported. |
| App will not start on macOS | Move the app to Applications and open it from there; confirm the security prompt. |
| Windows SmartScreen warning | Verify the checksum and publisher, then choose More info → Run anyway. |
Logs for support can be exported under Settings → Help → Export logs. They never contain private keys or your recovery phrase.
Uninstalling
- Windows: Settings → Apps → JuBiter Wallet → Uninstall.
- macOS: drag JuBiter Wallet from Applications to the Trash.
- Linux: delete the AppImage, or run
sudo apt remove jubiter-wallet.
Removing the app does not affect your funds — they are secured by the device and your recovery phrase.
Developers & SDK
The JuBiter SDK is written mostly in C++ with strict C interfaces and bindings for Swift and Java. It supports HID and BLE devices and includes a simulator for testing. Source code and examples are available on GitHub.
