You can remove BitBoxBridge when you no longer need it for a supported web wallet, or when a clean reinstall is needed to repair its installation. Removing it does not uninstall the BitBoxApp, erase your BitBox or change your wallet backup.
Use the removal steps for your operating system below. You do not need recovery words, a device password or an optional passphrase for this procedure.
Before you start
- Disconnect your BitBox and close browser windows using a web wallet.
- Make sure you have administrator permission for the computer. On a managed work computer, ask its administrator to remove the software.
- If a wallet cannot connect but the Bridge status page still works, investigate the connection before reinstalling. A working service alone does not establish that the browser or wallet can use the device. Do not uninstall Bridge merely because a wallet shows an unfamiliar balance.
Uninstall on Windows
- Open the Start menu and select Settings.
- Open Apps, then Installed apps or Apps & features, depending on your Windows version.
- Find BitBoxBridge. Open its options menu or select the entry, then choose Uninstall.
- Follow the removal prompts and wait for completion. Approve a Windows administrator prompt only for the removal you started. If the uninstaller requests a restart, restart before checking the result.
The uninstaller stops and removes the BitBoxBridge background service. Return to the installed-app list and confirm that BitBoxBridge is no longer listed.
Uninstall on macOS
For the official package installation, remove both the background-service configuration and the BitBoxBridge program folder, then restart your Mac. Delete only the exact items named below; leave other service files and folders in place.
Remove the background-service configuration
- Open Finder. In the menu bar, select Go > Go to Folder….
- Enter
/Library/LaunchDaemons/and press Return to open that system folder.

- Find the file named
ch.shiftcrypto.bitboxbridge.plist. Select that exact file and move it to the Trash. If macOS asks for authorization, use your Mac administrator password.
If the file is absent, do not delete a similarly named file. Continue to check the program folder below. If Finder refuses removal, stop and contact Support with the error rather than changing permissions on the system folder.
Remove the program folder and restart
- In Finder, select Go > Go to Folder… again. Enter
/opt/shiftcrypto/and press Return.

- Find the folder named
bitbox-bridgeand move that folder to the Trash. Leave the parentshiftcryptofolder and any other contents in place. Authorize the removal if macOS requests your Mac administrator password.

- Save other open work, then choose Apple menu > Restart…. Complete the restart before checking whether Bridge still responds.
If the program folder is absent, leave other folders unchanged and complete the restart. Removing files alone may not stop a process that is already running; the restart is part of this procedure.
Uninstall on Linux
These commands apply to Bridge installed using the official .deb or .rpm package. If you installed it manually from an archive or source, do not use these commands as proof that your manual installation was removed; contact Support for the relevant steps.
- Open Terminal and enter the command for your package manager below.
Ubuntu or Debian:
sudo apt-get remove bitbox-bridgeFedora:
sudo dnf remove bitbox-bridgeopenSUSE:
sudo zypper remove bitbox-bridge- If prompted, enter your computer account's administrator password. Terminal may not display characters as you type. Review the removal list before confirming: it should identify
bitbox-bridge. If it proposes unexpected software removal, cancel and ask Support. - Wait for the package manager to finish without an error. The package's removal script stops Bridge and disables its automatic startup. If the package manager reports that it is not installed, that does not rule out a separate manual installation.
Check the result
- After removal, and after the required macOS restart or any restart requested on Windows, open a browser on that computer.
- Enter http://127.0.0.1:8178/ in the address bar and reload the page. The BitBoxBridge status page should no longer load.
A failed connection confirms that Bridge is no longer reachable at its usual local address; by itself it does not prove every installation file is gone. Combine this check with successful completion of the removal steps for your system. If a fresh BitBoxBridge status page still appears, contact BitBox Support with your operating system, installation method and the step that failed. Do not repeatedly delete files or reset your hardware wallet.
If you are reinstalling
Once removal is complete, follow Install BitBoxBridge to download the official package, install it and check its local status page. Then retry the hardware-wallet connection using the guide for your chosen wallet. You do not need to reset the BitBox or restore a backup.