You can enter your optional passphrase in the BitBoxApp after unlocking your BitBox with its device password. You’ll approve app entry on the BitBox first, then check the exact passphrase on its display before opening your wallet.

Before you use app entry

You need BitBoxApp 4.53.0 or later, BitBox firmware 9.28.0 or later, and the optional passphrase feature enabled. The Cresta update includes firmware 9.29.0. Follow the guides to update the BitBoxApp or update your BitBox firmware if either version is older.

If the passphrase prompt is disabled, unlock your BitBox and open Settings → Manage device → Expert settings → Passphrase. Follow the optional passphrase setup guide, then reconnect your BitBox.

Use app entry only on a computer or phone you trust

Entering the passphrase directly on your BitBox is the safer default. Malicious software on the connected computer or phone could capture what you type or read the passphrase from the clipboard when you copy it, even if you verify the passphrase on the BitBox afterward. Use the official BitBoxApp and start the request yourself during unlock. Always enter your device password on the BitBox. Keep your recovery words off your computer and phone, and never share your passphrase with anyone, including BitBox Support.

 

Enter and verify your passphrase

  1. Open the BitBoxApp and connect your BitBox. Choose the display orientation on the BitBox if prompted, then enter your device password on the BitBox. The app will show Enter BitBox passphrase.
  2. Select Enter passphrase in app on the app’s Unlock screen. The app asks you to approve app entry on your BitBox.

BitBoxApp Unlock screen with the Enter passphrase in app option

  1. When your BitBox asks Enter passphrase on host?, tap the touch sensor by the check mark. The computer or phone running the app is the host. Decline the request on your BitBox if you didn’t start it or would prefer to enter the passphrase directly on the device.

BitBoxApp dialog waiting for you to approve app entry on the BitBox

  1. In the BitBoxApp’s Enter passphrase dialog, type or paste the exact passphrase for the wallet you want to open. If you already keep it in a password manager, you can copy it from there and paste it into the field while it’s hidden. Select Confirm. The app then shows Confirm passphrase on BitBox.

BitBoxApp passphrase dialog with an empty field and the Confirm button

  1. On your BitBox, tap the next arrow when it tells you that you’ll visually confirm the passphrase. Compare the entire passphrase on the BitBox display with the exact one you intend to use, including capitalization, spaces and symbols. Scroll through it if needed. If it matches, touch and hold the sensor by the check mark to confirm. If it differs, reject it and enter it again.

BitBoxApp waiting for you to verify and confirm the passphrase on the BitBox

After you confirm, the BitBoxApp opens the wallet for that passphrase. A typo can open a different wallet without an error. Before receiving or sending funds, compare Settings → Manage device → Device information → Root fingerprint with the record for the wallet you meant to open. If it differs, disconnect and reconnect your BitBox and retry with the exact passphrase before using the wallet.