This article explains how to clear the BitBoxApp cache. This is a useful troubleshooting step for a limited number of issues, such as an outgoing transaction that appears to be stuck.
Before you start
Clearing the cache is safe and will not affect your funds. Your wallet and transaction history are stored on the blockchain, not in the BitBoxApp.
However, this process will reset local app settings. Custom account names and transaction labels will be removed, but you can easily restore them from a backup. Learn how in our guide: [How to import and export your transaction notes].
How to clear the cache
Follow the steps for your computer's operating system.
Windows
- Press the
Win+Rkeys to open the Run dialog. - Paste
%APPDATA%\bitbox\into the field and press Enter. - In the folder that opens, find and delete the
cachefolder. - Restart the BitBoxApp.
macOS
- Open Finder.
- Press
Shift+Command (⌘)+Gto open the 'Go to Folder' dialog. - Type
~/Library/Application Support/bitbox/and press Enter. - In the folder that opens, find and delete the
cachefolder. - Restart the BitBoxApp.
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.
Android and iOS
On mobile devices, the BitBoxApp cache is cleared by uninstalling and reinstalling the application. There is no separate cache folder to delete.
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.