This guide helps you quickly resolve common MyEtherWallet errors when using your BitBox02.
Before diving in, ensure that:
- Your BitBox02 firmware is up to date via the BitBoxApp .
- You’ve performed a hard refresh (Ctrl + F5 on Windows/Linux; Cmd + Shift + R on Mac) to clear any caching issues.
Common errors and solutions
If MyEtherWallet shows an error message, find the matching entry below.
Error message |
Proposed solution |
|---|---|
BitBoxBridge not found |
Download and install the BitBoxBridge; if already installed, make sure it’s running by following the Bridge instructions below. |
Unlock BitBox02 |
Enter your password on the BitBox02 to unlock. |
Unexpected error |
Disconnect and reconnect your BitBox02, then retry. |
Action aborted by user |
You canceled the process on the BitBox02; try again. |
Your BitBox02 is not initialised |
Download and install the BitBoxApp to set up your BitBox02. |
Please upgrade to the newest firmware using Shift Crypto’s App |
Open the BitBoxApp to update your BitBox02 firmware. |
MyEtherWallet does not yet support this version of the firmware |
Hard refresh MyEtherWallet; if the issue persists, await their next update. |
Trying to connect from a non‑whitelisted origin |
Check for phishing: the correct URL is https://myetherwallet.com. |
Expected exactly one BitBox02 |
Ensure only one BitBox02 is plugged in at a time. |
Pairing rejected on device |
Reconnect and accept the pairing code by tapping the check mark on your BitBox02 when prompted. |
Your BitBox02 is busy |
Close the BitBoxApp and any other wallets (e.g., Electrum) before reconnecting. |
Device attestation failed |
Reconnect your BitBox02 and try again. |
Unsupported BitBox device |
MyEtherWallet supports only BitBox02 Multi or BitBox01. Bitcoin‑only BitBox02 editions are not compatible. |
Plug in BitBox02 and choose screen orientation by tapping sides |
Insert and power the BitBox02, then tap either side to select orientation; the USB connection establishes only after orientation is chosen. |
Issue: Bridge not found
To use MyEtherWallet, BitBoxBridge must be installed and running. Verify by visiting http://127.0.0.1:8178/ in your browser—you should see a status page like:
BitBoxBridge v1.1.0
GET /api/info
GET /api/v1/devices
GET/WS /api/v1/socket/:socket If you don’t see this, follow the steps below to restart the service .
Windows
- Open the Windows search bar and type services.
- Find bitbox-bridge in the list.
- Check its status:
- If blank or stopped, right‑click bitbox-bridge → Start.
- To auto‑start on boot: right‑click → Properties → set Startup type to Automatic.
macOS
- Open Activity Monitor and search for bitbox-bridge.
- If not listed, it’s not running.
- To restart:
- Select bitbox-bridge → click the “✕” in the upper left.
- Or in Terminal run:
sudo launchctl unload /Library/LaunchDaemons/ch.shiftcrypto.bitboxbridge.plist
sudo launchctl load /Library/LaunchDaemons/ch.shiftcrypto.bitboxbridge.plist
``` [oai_citation_attribution:8‡BitBox Support Hub](https://support.bitbox.swiss/en_US/myetherwallet/myetherwallet-troubleshooting?utm_source=chatgpt.com) Linux
- In a terminal, run:
systemctl status bitbox-bridge - You should see it active (running).
- To stop/start manually:
sudo systemctl stop bitbox-bridge
sudo systemctl start bitbox-bridge
``` [oai_citation_attribution:9‡BitBox Support Hub](https://support.bitbox.swiss/en_US/myetherwallet/myetherwallet-troubleshooting?utm_source=chatgpt.com) Issue: The pipe is being closed
Need more help?
If these steps don’t resolve your issue, try reaching out directly to MyEtherWallet support at support@myetherwallet.com. They’re happy to help with any remaining connectivity or integration questions.