Skip to main content

​
Connection

Electrum connection error message

Electrum connection error.

  • Check host, port, and protocol. SSL usually uses 50002. TCP usually uses 50001.
  • Confirm the server is on mainnet and fully synced.
  • .onion address? Turn on Connect via Tor. Tor can take up to two minutes to start.
  • Using a StartOS Root CA? Install the CA on your computer. Fully quit and reopen the app.
  • Select Test Connection in Settings to check.
Control Center can’t reach your Electrum server right now. It shows your last saved balances and keeps retrying. Fix the connection above.
  • Check your internet connection. Some networks block Tor.
  • “Tor could not connect within two minutes”: try again on another network.
  • “Bundled Tor is missing”: reinstall the desktop app.
Control Center waits for Electrs. Check Electrs is running and fully synced. Then restart Control Center.
Open the https:// address or the .onion address. The PIN doesn’t work over plain http://.

​
Balances

Account still syncing with zero balance

Still syncing.

  • Wait for the first sync to finish.
  • Confirm your Electrum server is fully synced.
  • Wrong address type. Added by xpub? Pick the script type that matches your addresses. See xpub or descriptor.
  • Wrong account. Check you picked the right account number or passphrase wallet.
  • Unconfirmed funds don’t count yet. Wait for one confirmation.
Scans only list accounts with a balance above zero. Ledger also stops at the first empty account. Add the wallet by xpub or descriptor instead.
  • ”—” means a balance couldn’t be confirmed. Select Try Again.
  • A drop usually means an exchange needs Reconnect, or you archived a wallet. See Home and Portfolio.
You connected the same exchange twice. Open one and select Remove Account. This deletes it immediately.

​
Hardware wallets

Browser permission prompt to connect a hardware wallet

Allow the browser prompt.

  • Unlock it. Open the Bitcoin app.
  • Close Ledger Live, Trezor Suite, and other wallet apps.
  • Use a USB cable that carries data, not just power.
  • On StartOS or Umbrel, use Chrome, Brave, or Edge. Firefox and Safari can’t connect to a Ledger.
Allow pop-ups for Control Center. If asked, allow local network access so it can find Trezor Suite desktop.
Allow camera access in your browser and operating system. Close other apps using the camera.
USB isn’t supported. Use a MicroSD card, or a COLDCARD Q with its QR codes.
Check the device screen. After 20 seconds, select the reset link and try again.
Sign the exact message with the exact address shown. See Verify ownership.
That device’s key isn’t in the descriptor. Check the device, passphrase, and account. See Multisig.

​
Exchanges

Exchange connection failed error

Exchange connection error.

  • Re-copy the key. Check for extra spaces.
  • Confirm the key has the right read permission. See Exchanges.
  • Coinbase: use an ECDSA key, and paste the whole private key.
  • Strike: turn on Read account balances. It’s off by default.
  • Create a new key and try again.
Keys expire in Control Center after one year, or after a restore without the key file. Create a new key. Open the account. Select Reconnect Account.
The exchange is limiting requests. Wait a few minutes and select Refresh Balance.

​
Statements

Only verified self-custody wallets can go on statements. Verify it. Exchanges, manual, and ETF holdings never appear.
Statements must end at least 2 days ago, so recent transactions can confirm. They can start no earlier than April 2023 and cover up to 2 years.
Statement generation error

Statement error.

  • Check your Electrum connection.
  • On StartOS or Umbrel, make sure Mempool is running.
  • “Generation was interrupted” means the app restarted. Generate it again.
  • See If a statement fails.
Download saves the format shown in the viewer. Switch to Full Period first.

​
App and PIN

See PIN and lock. Your data stays.
Wait for the timer. Each wrong try after the fifth doubles the wait, up to 1 hour.
The app or server restarted. Enter your PIN again.
That’s expected. It keeps running in the tray and locks. Use Quit in the tray menu to quit fully.
Download the official release from bitcoincontrolcenter.com. Test builds are not notarized.
Select More info → Run anyway.
Still stuck? Contact support.