This article shows you how to clear the BitBoxApp cache. This is a troubleshooting step for a very limited number of issues, like an unconfirmed outgoing transaction that appears stuck.
This process is safe and will not delete your wallets, funds, or main configurations.
Important: What happens when you clear the cache
Before you start, it's important to understand what this process does.
- It will reset some app settings. Specifically, it will remove your account names and any transaction labels you have set. Your accounts will still be there, but they will revert to their default names.
- Labels can be restored. You can restore your account names and transaction labels. Learn how in our guide on how to import and export notes.
How to clear the cache
Follow the steps for your computer's operating system.
On Windows
- Press the
Win
+R
keys to open the Run dialog. - Paste
%APPDATA%\bitbox\
into the field and press Enter. - In the folder that opens, find and delete the
cache
folder. - Restart the BitBoxApp.
On macOS
- Open Finder.
- Press
Shift
+Command (⌘)
+G
to open the 'Go to Folder' dialog. - Type
~/Library/Application Support/bitbox/
and press Enter. - In the folder that opens, find and delete the
cache
folder. - Restart the BitBoxApp.
On Linux
- Open your Terminal application.
- The bitbox folder is located in one of two places. To open it in your file manager, use one of the following commands in the terminal:
xdg-open ~/.config/bitbox/
- or
xdg-open ~/.local/share/bitbox/
- In the folder that opens, find and delete the cache folder.
- Restart the BitBoxApp.
What this process does not fix
Clearing the cache will not solve connection problems. If the BitBoxApp cannot connect to the internet, or can't find your BitBox02, the issue is likely caused by a VPN, Tor, antivirus software, or other local network settings. For solutions to these kinds of issues, please see our guide on what to do when your BitBoxApp accounts are not loading.
Still having trouble?
If clearing the cache does not solve the problem, our support team is ready to help. To get a faster solution, please include the following information in your support request:
- Your computer model and operating system version
- Your BitBoxApp version and the firmware version of your BitBox02
- A short description of the steps you have already tried
- A video, photo, or screenshot that clearly shows the issue
- Your BitBoxApp log files. Learn how to find them here: How to get the BitBoxApp log files
You can contact us through the official BitBox support portal.