// troubleshooting guide · box
Box Drive Failed to Initialize on Mac
- Status
- Workaround available
- platforms:
- macOS
- updated:
- November 22, 2026
- reports:
- 3
- Method
- how we research
RUNBOOK · box/box-drive-failed-to-initialize-mac3 FIXES
// quick answer
On macOS 11.5+ Box Drive in File Provider mode can fail at startup because an old folder already exists at ~/Library/CloudStorage/Box-Box. Moving that folder aside or running Box's Reset Tool usually fixes it.
Most likely fix: Move the old Box folder aside
How to fix it
// try these in order, the most common fix is first
FIX 1Move the old Box folder aside
- 01Quit Box Drive
- 02In Finder press Cmd+Shift+G and open ~/Library/CloudStorage
- 03Rename Box-Box to Box-Box-old (or move it to the Desktop)
- 04If Terminal says Operation not permitted, add Terminal under System Settings > Privacy & Security > Full Disk Access
- 05Relaunch Box Drive and sign in
Did this fix it?FIX 2Run the Box Reset Tool
- 01Download the Box Reset Tool from Box support
- 02Run it and let it finish (it writes logs to the Desktop)
- 03Relaunch Box Drive and sign in again
- 04Back up ~/Library/Application Support/Box/Box/unsyncedFiles first, since a reset deletes unsynced files
Did this fix it?FIX 3Reinstall Box Drive
- 01Quit Box Drive and drag it from Applications to the Trash
- 02Reboot the Mac
- 03Download the latest Box Drive from box.com/resources/downloads and install it
Did this fix it?
SANDBOX · box RUNS IN YOUR BROWSER
Try it: upload, share a link and sync with Box Drive
A hands-on Box-style sandbox, including the spots where users get stuck. See where problems like this one start. 1-2 minutes, nothing is saved.
Symptoms
Box Drive says it failed to initialize or asks you to relaunch; the Box icon never turns green and no Box folder appears in Finder.
Why it happens
- C-01A leftover Box-Box folder in ~/Library/CloudStorage from a previous install
- C-02Corrupted File Provider domain after an update or macOS upgrade
- C-03Terminal or Box lacking Full Disk Access
// this guide also covers
- box drive failed to initialize mac
- box drive not working on mac
- box not working on mac
Still not working?
If Box keeps failing, you're not alone. See every Box problem users report or the alternatives people switch to.
Have an app idea? Our small team builds any software: web and mobile apps, games, desktop, AI tools. Price agreed together.
Talk to usOther Box errors
- Box Drive Not Syncing
- Box Upload Failed
- Box File Size Limit (File Too Large to Upload)
- Box Drive Problem Items ('Error Updating an Item')
- Box 'Account Storage Limit Reached' Error
- Box Drive Not Opening or Disappearing After Login
- Box Drive Not Showing in Finder on Mac
- Box Drive Taking Up Too Much Disk Space