Restore your Lightning wallet after reinstalling the BitBoxApp or moving to another phone by connecting the BitBox wallet that originally created it. If you no longer have that BitBox, first restore its existing backup on a compatible replacement BitBox. You also need the exact optional passphrase if the original wallet used one.

The BitBox recreates the Lightning keys; the BitBoxApp needs Spark to retrieve the wallet's current state. Recovery therefore requires both the correct BitBox wallet and an available Spark connection.

Choose your situation

  • You reinstalled the app or are moving to a phone you control: follow the preparation and restoration steps below.
  • Lightning is only disabled in the same app installation: follow Re-enable the same Lightning wallet instead.
  • A phone is lost, stolen, or no longer trusted: contact BitBox Support promptly for guidance on protecting the remaining Lightning balance. Restoring on another phone does not deactivate the old installation. Its spending keys remain on that phone, and anyone with access to the wallet may be able to spend without your BitBox.
  • You used Close and withdraw funds: this guide is not a way to reverse the withdrawal or bring back the withdrawn balance. Contact Support if the withdrawal has not arrived in your Bitcoin account.

Prepare the correct BitBox wallet

Use the latest supported BitBoxApp on a supported Android device, iPhone, or iPad. Lightning is not available in the desktop app. On Android, connect your BitBox by USB using a device with USB OTG support. On iPhone or iPad, you need BitBox Nova, which uses Bluetooth for communication and a physical connection for power. Check the device and operating-system requirements and get the app from an official download source.

Keep your wallet backup off the phone

Restore recovery words or a microSD backup only through your BitBox hardware wallet's recovery procedure. Never type recovery words, an optional passphrase, private keys, or your BitBox device password into the BitBoxApp, a website, a chat, or a support form. Never upload a backup file. BitBox Support will never ask for these secrets.

 
  1. If the original BitBox is unavailable, restore its existing wallet on a compatible replacement using your microSD backup or recovery words. Do not reset a device containing another wallet without first protecting that wallet's backup and any required passphrase.
  2. Connect and unlock the BitBox containing the original wallet. If it used an optional passphrase, enter that exact passphrase on the BitBox. A mistyped passphrase opens a different wallet without an error; it would also derive a different Lightning wallet. The passphrase is not included in the microSD or recovery-word backup.
  3. Check that the expected on-chain accounts and transaction history appear. Stop if you cannot identify the original wallet. If the BitBoxApp requires a firmware update before enabling Lightning, complete the update offered for your BitBox before continuing.
  4. Open Settings → Manage device. Under Device information, privately note the Root fingerprint of the wallet currently open. Keep that wallet open for the restoration. If you recorded its fingerprint before losing access, compare it now. A short fingerprint is an additional identity check, not proof by itself.

Restore Lightning in the BitBoxApp

The app uses the same activation flow for creation and restoration. The wallet open on your BitBox determines which Lightning keys it derives; the wording Create Lightning wallet does not by itself mean you are recovering the intended wallet.

  1. With the prepared BitBox connected and unlocked, open Settings → Advanced settings → Enable Lightning wallet. If you see Lightning settings instead, a wallet is already active. Check its identity and use the wallet management guide before switching.
  2. Read What is Lightning? and select Next. On How does it work with the BitBoxApp?, read the explanation, select I have read the information above, then select Next.
  3. Read the Lightning disclaimer, then select Agree and continue if you accept the conditions. Lightning spending keys are stored on the phone, and ordinary payments do not require BitBox approval. If asked to reconnect or unlock your BitBox, use the same wallet you checked above.
  4. When the app shows Create Lightning wallet, check the request on your BitBox. Confirm Create Lightning Wallet on host device only if you initiated this restoration on a mobile device you control.
  5. Wait while the app enables Lightning and connects. When it displays Success, your Lightning wallet is ready!, select Done. Continue with the checks below before receiving or sending funds.

Verify that the expected wallet returned

  1. Open Settings → Advanced settings → Lightning settings. Under Wallet, compare the displayed fingerprint with the Root fingerprint you noted before activation. The wallet name, if shown, is an additional reference.
  2. Check that Status shows Connected, then open the Lightning wallet and compare its balance and payment history with what you expect.
  3. Check the current Lightning receiving address before sharing it. Do not assume a previously shared address is still the active one.

Restoration is complete when the intended wallet is connected and its expected balance and history are available. The fingerprint comparison confirms that activation used the BitBox wallet you selected; if you have no earlier fingerprint record, it does not independently establish that you selected the original wallet. Stop if the history or identity is unexpected.

Keep your existing BitBox backup protected and any optional passphrase separately backed up. No separate Lightning recovery-word backup is required.

If restoration does not return the expected wallet

  • The fingerprint differs: stop and check which standard or passphrase wallet is open on the BitBox. Do not add funds to an unexpected Lightning wallet.
  • The balance or history is missing: first check the connection status and whether the original BitBox wallet and exact passphrase were used. An empty wallet alone does not identify the cause. Do not create additional wallets or reset your BitBox to try to fix it.
  • Spark is unavailable: preserve your BitBox backup and any existing local wallet data, and retry after service recovery. The current BitBoxApp depends on Spark to retrieve wallet state and move funds back to Bitcoin; it cannot independently force an exit using recovered keys alone.

If you remain unable to restore access, contact BitBox Support. Include your BitBox model, BitBoxApp and firmware versions, mobile operating system, the step where you are stuck, connection status, and exact non-sensitive error text. Never include recovery words, backup files, an optional passphrase, private keys, passwords, or PINs.