If the BitBoxApp is not behaving as expected, clearing its local cache can help resolve certain app problems. The recommended method is the built-in Clear cache option, available on every supported platform in BitBoxApp 4.52.0 or later.

Clearing the cache removes locally cached app data. Your account names, notes, and wallets are not affected.

Clear the cache in the BitBoxApp

Use this method whenever the BitBoxApp opens and you can access its settings. The cache is cleared immediately after you confirm the action.

1. Open the BitBoxApp and select Settings. On desktop, Settings is in the left sidebar; on Android, iPhone, and iPad, it is in the navigation bar.
2. Select Advanced settings.
3. Scroll to Clear cache and select it.
4. Read the information in the confirmation window, then select Clear Cache.

The confirmation window closes when the cache has been cleared. Return to the affected area of the BitBoxApp and retry the action that was not working.

If you do not see Clear cache

The built-in option requires BitBoxApp 4.52.0 or later. Open Settings → About to check the installed version. If it is older, update the BitBoxApp and try again.

The option was introduced with the BitBox 09.2026 Meggen update.

If you cannot clear the cache from the BitBoxApp

Use the manual method only when the BitBoxApp cannot open, you cannot reach the built-in option after updating, or the built-in action does not complete. Manual cache removal is supported on Windows, macOS, and Linux.

Windows

1. Quit the BitBoxApp.
2. Press Win + R to open the Run dialog.
3. Enter %APPDATA%\bitbox\ and press Enter.
4. Move the folder named cache to the Recycle Bin.
5. Reopen the BitBoxApp.

macOS

1. Quit the BitBoxApp completely by pressing Command (⌘) + Q.
2. Open Finder and press Shift + Command (⌘) + G.
3. Enter ~/Library/Application Support/bitbox/ and press Return.
4. Move the folder named cache to the Trash.
5. Reopen the BitBoxApp.

Linux

1. Quit the BitBoxApp.
2. Open a terminal and run xdg-open ~/.config/bitbox/.
3. Move the folder named cache to the Trash.
4. Reopen the BitBoxApp.

If the bitbox folder is not under ~/.config and you intentionally configured XDG_CONFIG_HOME, open $XDG_CONFIG_HOME/bitbox/ instead.

The BitBoxApp automatically creates a new cache folder when it starts. Once the app opens, return to the affected area and check whether the original problem has been resolved.

If the problem continues

Clearing the cache does not change your network, VPN, Tor, firewall, antivirus, or personal full-node settings. If an account remains stuck loading or does not update, follow BitBoxApp accounts not loading: how to fix connection issues.

If clearing the cache does not resolve the problem, contact BitBox Support. Include your computer or mobile device model, operating-system version, BitBoxApp version, a short description of the problem and the steps already attempted, and a screenshot or video when it helps show the issue. You can also follow How to locate and export BitBoxApp support files.

Never include recovery words, private keys, passwords, an optional passphrase, a wallet backup, or authentication codes in a support request.