If the BitBoxApp will not install or open on your Mac, use the section below that matches the message or the step that fails. A normal confirmation that the app was downloaded from the internet needs a different response from a damaged-app or malware warning.

Check the BitBoxApp system requirements before retrying. If your macOS version is unsupported, use a supported system rather than trying to bypass the requirement.

macOS says the app was downloaded from the internet

This confirmation can appear the first time you open a downloaded app. If the dialog simply asks whether you want to open the BitBoxApp, select Open only if you downloaded it from the official BitBoxApp download page. The app should then open.

If the message instead mentions an unverified developer, malicious software, or damage, use the matching section below before continuing.

Apple cannot check the app or verify its developer

A message that Apple cannot check the BitBoxApp for malicious software or cannot verify its developer means macOS has not established the trust needed to open it normally. Do not treat this as the ordinary internet-download confirmation.

First obtain a fresh macOS download from the official page and follow Install the BitBoxApp on macOS. If the same warning returns, verify the downloaded BitBoxApp signature before considering an exception. If verification fails or you cannot complete it confidently, stop and contact Support using the details at the end of this article.

Only on a personal Mac you trust, with a successfully verified official download and no damaged-app or malware alert, you can allow this individual app. These steps use System Settings; if your Mac instead has System Preferences, contact Support for guidance for your macOS version.

1. Try opening the installed BitBoxApp from Applications in Finder, then dismiss the warning.
2. Open the Apple menu → System Settings → Privacy & Security. Scroll to Security and find the blocked BitBoxApp message.
3. Select Open Anyway, then Open when macOS asks you to confirm. Authenticate in the macOS system prompt if requested.

If the app opens, macOS retains an exception for that app. This does not disable Gatekeeper for other apps. If Open Anyway is unavailable or a different warning appears, stop. On a work or school Mac, ask the administrator; otherwise contact BitBox Support. Do not disable Gatekeeper or remove quarantine attributes with Terminal commands.

macOS says the app is damaged or will damage your computer

Do not override either warning. A damaged-app message can indicate corruption or tampering; a warning that the app will damage your computer, contains malware, or was moved to the Trash is a separate security alert.

• Damaged app: record the exact message, then download a fresh DMG from the official page. Before opening it, check its SHA-256 checksum. If it matches, retry the normal installation. If the check fails or the warning returns, stop and contact Support.
• Malware or “will damage your computer” alert: leave the file blocked or quarantined and contact Support before trying another copy. On a managed Mac, also inform the administrator. A matching checksum or signature is not permission to bypass this alert.

The downloaded DMG file will not open

If there is a security alert, use the sections above. Otherwise, an incomplete download is one possible reason the disk image will not open.

1. Download a fresh macOS file from the official download page. Wait until the browser reports that the download is complete.
2. In Finder, open Downloads and double-click the new file ending in .dmg. If it opens, continue with the macOS installation guide to copy the app into Applications.

If the new DMG also fails to open, record its filename and the complete error message for Support rather than repeating the download.

Copying the BitBoxApp into Applications fails

If macOS says the app is in use, quit the BitBoxApp and retry copying it from the mounted disk image into Applications. Select Replace if asked to replace the existing app. If you cannot quit it, restart the Mac and retry before opening the app again.

If macOS requests administrator authorization, use an account authorized to install software on that Mac. If you do not have permission, ask the administrator. For another copying error, record the full message and contact Support; do not delete BitBoxApp settings or wallet data to make space or force installation.

The BitBoxApp closes immediately or will not start after an update

Use this path only when no unresolved security warning remains. First make sure you are opening the installed copy: in Finder, open Applications and double-click BitBoxApp, rather than launching it inside the mounted DMG.

If it still closes or will not start, restart your Mac once and try that same installed copy again. If the problem persists, follow the macOS installation guide to replace the app with a fresh official download. Keep application settings and wallet data in place; this procedure does not require a wallet reset or restore.

If the app still fails after replacement, stop repeating the installation and contact Support with the failed stage and any error message.

Confirm the result

Installation is complete when the BitBoxApp opens from Applications and stays open. If it opens but shows an older version, follow Update the BitBoxApp to check the version and complete the update.

If the app stays open but does not detect your BitBox, continue with BitBox detection troubleshooting on macOS.

Contact BitBox Support

If a warning remains unresolved or the matching steps do not help, contact BitBox Support. Include:

• your macOS version and Mac model, including Intel or Apple Silicon;
• the downloaded filename and BitBoxApp version, if known;
• whether opening the DMG, copying the app, or launching it from Applications fails;
• the exact error or warning, with a screenshot if possible; and
• whether the Mac is managed by a workplace or school, and which steps you have already tried.

Installation never requires recovery words or a wallet backup. Never send Support recovery words, backups, private keys, passwords, or passphrases. Check screenshots for personal information before sending them.