We are releasing a new version of Box Drive with a completely new architecture on macOS with Apple File Provider Extensions (FPE). This new version of Box Drive provides more seamless and secure access for Box Drive on Intel and Apple silicon devices and no longer requires use of kernel extensions.
The Box Drive installer also now includes two configurations: kernel-based mode and FPE mode.
Download the new version of Box Drive here.
Supported operating systems
- macOS Big Sur (11.5 and above), and
- macOS Monterey (12 and above)
- Apple silicon and
- Intel-based Mac devices
Rolling-out FPE mode
Below are the details on the roll-out plan for different users.
When Box Drive v2.24 is released, Box will automatically configure all macOS 12 users to use Drive in FPE mode (since that will be the only supported configuration).
All other enterprise users will be able to continue using the kernel-based mode after upgrading to (v.2.24.193). Soon, Box will automatically configure all enterprise users on macOS 11.5 and greater to FPE mode. This change will take effect when users restart Box Drive after Box enables the configuration.
Box will configure FPE mode for all other Individual Users by default at the GA of Drive v2.24.
This change will take effect when users restart Box Drive after Box enables the configuration.
Enabling FPE mode
If you're an enterprise user and want to enable the FPE configuration before Box enables it one month after GA, please follow the instructions below:
Run the following command in Terminal:
defaults write com.box.desktop MacMode fpe (Important note: This command needs to be run as the current user, not as sudo)
Restart Box Drive.
Note: We are actively fixing some high CPU usage bugs and crashes in the FPE mode (here is a list of known issues). We recommend you test in your environment to ensure you do not encounter any of these issues before you enable this mode for enterprise user.
If you're an enterprise admin and want to enable FPE mode for your enterprise's users via JAMF, see this JAMF article to learn how to push commands as current user and not as sudo.
Remaining in kernel mode
If you're an enterprise user and want to stay in kernel-based mode on Drive after the one-month post-GA period, and you prefer not to have FPE mode enabled for macOS 11.5 users, please follow the instructions below for select users:
Run the following command in Terminal:
defaults write com.box.desktop MacMode fuse (Important note: This command needs to be run as the current user, not as sudo)
Restart Box Drive
If you're an enterprise admin and want to keep your users on macOS 11.5 in kernel-based mode, see this JAMF article to learn how to push commands as current user and not as sudo.
Important differences between kernel-based and FPE modes
Please note the following major changes between kernel-based mode and FPE mode:
Mac Packages are now supported.
Custom Mount Location on macOS 11.5 and 12 in FPE mode is no longer supported due to an architectural limitation in Apple File Provider Extensions.
Admins will no longer be able to customize the cache size for users.
Notable changes in user experience
Overlay icons are refreshed to align with other system icons.
The Box folder has a different mount location for FPE, compared to kernel-based Drive:
These are controlled by macOS, not Box Drive, and could change without notice
In FPE mode: ~/Library/CloudStorage/Box-Box
In kernel-based mode: ~/Box
Box is now available under "Locations" in Finder.
- Files dragged and dropped from a user's local drive into Box need to be moved instead of copied.
- Existing Favorites will not be carried forward from kernel-mode to FPE mode, so you'll need to manually re-add Box folders under "Favorites".
- Mac Package files opened in iWork will not support real-time collaboration. You can still edit package files in iWork, but cannot do it using real-time collaboration. Non-package files opened in iWork will continue to support real-time collaboration.
- Box Drive's Custom Mount Location feature is no longer supported on Apple macOS devices configured using the FPE mode of Box Drive(v 2.23.193 or above). Custom Mount Location continues to work if you're using the legacy kernel-based Box Drive configuration on macOS 11.x and 10.15. For more details, see this article.