-->

There are two basic ways that you, as an administrator, can deploy the OneDrive sync app to Mac users in your organization:

Download and install Microsoft OneDrive for Windows PC, Mac, iOS and Android. Download and install Microsoft OneDrive for Windows PC, Mac, iOS and Android. Skip to main content. Get the OneDrive mobile app 1. Enter your email address and we’ll send a download link. Send now Your message is being sent.

• Have users install and set up the OneDrive sync app themselves by following the instructions in Sync files with OneDrive on Mac OS X. To install the OneDrive sync app for Mac, a user has to be an administrator on the Mac or know an administrator account name and password.

• Download the installer package file to your local network, and then use your software distribution tools to deploy the app to your users. By using a software distribution tool, you have more control over the deployment, including which users get the sync app and when. The OneDrive sync app for Mac uses the Apple Installer technology for installation. This means you can continue to use the software distribution tools that you normally use to deploy software to Mac users. You can use Microsoft Intune. Other common tools are Jamf Pro, Munki, and AutoPkg. You can also use Apple Remote Desktop and AppleScript.

Manage OneDrive settings on macOS using property list (Plist) files

After the OneDrive sync app for Mac is installed, users can configure settings for the app. These settings are called preferences. As an administrator, you might want to provide users in your organization with a standard set of preferences. Preferences for the OneDrive sync app for Mac are stored in preference files. These files are often referred to as .plist files.

Configure sync app settings

Configure the settings on macOS as follows:

1. Quit the OneDrive app.

2. Define the settings you want to change by creating a Plist file with the values, or use a script to set the default values.

3. Deploy the settings onto the local computer.

4. Refresh the preferences cache.

   On the next start of OneDrive, the new settings will be picked up.

Overview of settings

Use the following keys to preconfigure or change settings for your users. The keys are the same whether you run the standalone or Mac App Store edition of the sync app, but the Plist file name and domain name will be different. When you apply the settings, ensure that you target the appropriate domain depending on the edition of the sync app.

List of settings

AllowTenantList

This setting prevents the users from uploading files to other organizations by specifying a list of allowed tenant IDs. If you enable this setting, the user gets an error if they attempt to add an account from an organization that is not in the allowed tenants list. If the user has already added the account, the files stop syncing. This setting takes priority over Block syncing OneDrive accounts for specific organizations setting. Do NOT enable both settings at the same time.

The parameter for the AllowTenantList key is TenantID and its value is a string which determines the tenants for whom the Allow Tenant setting is applicable. For the setting to be complete, this parameter also requires a boolean value to be set to it. If the boolean value is set to True, the tenant is allowed to sync.

The example for this setting in the .plist file is:
<key>AllowTenantList</key>
<array>
<dict>
<key>TenantId1</key>
<Bool>True</Bool>
<key>TenantId2</key>
<Bool>True</Bool>
</dict>
</array>

AutomaticUploadBandwidthPercentage

This setting enables the sync app to automatically set the amount of bandwidth that can be used for uploading files, based on available bandwidth.

To enable this setting, you must define a number between 1 and 99 which determines the percentage of bandwidth the sync app can use out of the total available bandwidth.

The example for this setting in the .plist file is:
<key>AutomaticUploadBandwidthPercentage</key>
<int>(Bandwidth)</int>

BlockExternalSync

This setting prevents the sync app from syncing libraries and folders shared from other organizations.

If you set the setting's value to True, the users are prevented from syncing OneDrive and SharePoint libraries and folders with organizations other than the user's own organization. Set this value to False or do not enable the setting to allow the OneDrive and SharePoint files to be synced with other organizations also.

The example for this setting in the .plist file is:
<key>BlockExternalSync</key>
<(Bool)/>

BlockTenantList

This setting prevents the users from uploading files to organizations that are included in the blocked tenant IDs list that is specified.

If you enable this setting, the users get an error if they attempt to add an account from an organization that is blocked. If a user has already added an account for a blocked organization, the files stop syncing. This setting does NOT work if you have Allow syncing OneDrive accounts for only specific organizations setting enabled. Do NOT enable both settings at the same time.

Onedrive App For Mac Os

You must enable this setting by defining IDs for the TenantID parameter which determines the tenants to whom the block tenant setting is applicable. You must also set the boolean value to True for the ID of every tenant you want to prevent from syncing with the OneDrive and SharePoint files and folders.

Note: In the list, inclusion of the tenant ID alone does not suffice. It is mandatory to set the boolean value to True for the ID of each tenant who is to be blocked.

The example for this setting in the .plist file is:
<key>BlockTenantList</key>
<array>
<dict>
<key>TenantId1</key>
<Bool>True</Bool>
<key>TenantId2</key>
<Bool>True</Bool>
</dict>
</array>

DefaultFolderLocation

This setting specifies the default location of the OneDrive folder for each organization.

The parameters are TenantID and DefaultFolderPath.The TenantID value is a string that determines the tenants to whom the default folder location setting is applicable.The DefaultFolderPath value is a string that specifies the default location of the folder.

The following are the conditions governing the default folder location:-Mac app store: The path must already exist when the user is setting up the sync app.-Standalone: The path will be created (if it doesn't already exist) after the user sets up the sync app. Only with the Standalone sync app you can prevent users from changing the location.

The example for this setting in the .plist file is:
<key>DefaultFolder</key>
<array>
<dict>
<key>Path</key>
<string>(DefaultFolderPath)</string>
<key>TenantId</key>
<string>(TenantID)</string>
</dict>
</array>

DisableHydrationToast

This setting prevents toasts from appearing when applications cause file contents to be downloaded.

If you set the setting's value to True, toasts do not appear when applications trigger the download of file contents.

The example for this setting in the .plist file is:
<key>DisableHydrationToast</key>
<(Bool)/>

DisablePersonalSync

This setting blocks users from signing in and syncing files in personal OneDrive accounts. If this setting has been configured after a user has set up sync with a personal account, the user gets signed out.

If you set the setting's value to True, the users are prevented from adding or syncing personal accounts.

The example for this setting in the .plist file is:
<key>DisablePersonalSync</key>
<(Bool)/>

DisableTutorial

This setting prevents the tutorial from being shown to the users after they set up OneDrive.

If you set this setting's value to True, the tutorial is blocked from being shown to the users after they set up the OneDrive.

The example for this setting in the .plist file is:
<key>DisableTutorial</key>
<(Bool)/>

DownloadBandwidthLimited

This setting sets the maximum download throughput rate in kilobytes (KB)/sec for computers running the OneDrive sync app.

You must set this setting's value to an integer between 50 KB/sec and the maximum rate is 100,000 KB/sec which determines the download throughput in KB/sec which the sync app can use.

The example for this setting in the .plist file is:
<key>DownloadBandwidthLimited</key>
<int>(Download Throughput Rate in KB/sec)</int>

FilesOnDemandEnabled

This setting specifies whether Files On-Demand is enabled.

If you don't set this setting, Files On-Demand will be enabled automatically as we roll out the feature, and users can turn the setting on or off.

If you set this setting to True, FilesOnDemand is enabled and the users who set up the sync app can view the online-only files, by default.

If you set this setting to False, FilesOnDemand is disabled and the users won't be able to turn it on.

The example for this setting in the .plist file is:
<key>FilesOnDemandEnabled</key>
<(Bool)/>

HideDockIcon

This setting specifies whether a dock icon for OneDrive is shown.

If you set this setting's value to True, the OneDrive dock icon is hidden even if the app is running.

The example for this setting in the .plist file is:
<key>HideDockIcon</key>
<(Bool)/>

HydrationDisallowedApps

This setting prevents apps from automatically downloading online-only files. You can use this setting to lock down apps that don't work correctly with your deployment of Files On-Demand.

To enable this setting, you must define a string in JSON format as described below:
[{'ApplicationId':'appId','MaxBundleVersion':'1.1','MaxBuildVersion':'1.0'}]
'appID' can be either the BSD process name or the bundle display name. 'MaxBuildVersion' denotes the maximum build version of the app that will be blocked. 'MaxBundleVersion' denotes the maximum bundle version of the app that will be blocked.

The example for this setting in the .plist file is:
<key>HydrationDisallowedApps </key>
<string> [{'ApplicationId':'appId','MaxBundleVersion':'1.1','MaxBuildVersion':'1.0'}, {'ApplicationId':'appId2','MaxBundleVersion':'3.2','MaxBuildVersion':'2.0'}]</string>
<(Bool)/>

OpenAtLogin

This setting specifies whether OneDrive starts automatically when the user logs in.

If you set this setting's value to True, OneDrive starts automatically when the user logs in on Mac.

The example for this setting in the .plist file is:
<key>OpenAtLogin</key>
<(Bool)/>

SharePointOnPremFrontDoorUrl

This setting specifies the SharePoint Server 2019 on-premises URL that the OneDrive sync app must try to authenticate and sync against.

To enable this setting, you must define a string containing the URL of the on-premises SharePoint Server.

The example for this setting in the .plist file is:
<key>SharePointOnPremFrontDoorUrl</key>
<string>https://Contoso.SharePoint.com</string>

SharePointOnPremPrioritizationPolicy

This setting determines whether or not the client should set up sync for SharePoint Server or SharePoint in Microsoft 365 first during the first-run scenario when the email is the same for both SharePoint Server on-premises and SharePoint in Microsoft 365 in a hybrid scenario.

If you set this setting's value to 1, it is an indication that OneDrive should set up SharePoint Server on-premises first, followed by SharePoint in Microsoft 365.

The example for this setting in the .plist file is:
<key>SharePointOnPremPrioritizationPolicy</key>
<int>(0 or 1)</int>

SharePointOnPremTenantName

This setting enables you to specify the name of the folder created for syncing the SharePoint Server 2019 files specified in the Front Door URL.

If this setting is enabled, you can specify a TenantName which is the name the folder will use in the following convention:
OneDrive – TenantName (specified by you)
TenantName (specified by you)

If you do not specify any TenantName, the folder will use the first segment of the FrontDoorURL as the its name. For example, https://Contoso.SharePoint.com will use Contoso as the Tenant Name in the following convention:
OneDrive – Contoso
Contoso

The example for this setting in the .plist file is:
<key>SharePointOnPremTenantName</key>
<string>Contoso</string>

UploadBandwidthLimited

This setting defines the maximum upload throughput rate in KB/sec for computers running the OneDrive sync app.

To enable this setting, set a value between 50 and 100,000 which is the upload throughput rate the sync app can use.

Onedrive App For Mac

The example for this setting in the .plist file is:
<key>UploadBandwidthLimited</key>
<int>(Upload Throughput Rate in KB/sec)</int>

You can also configure the OneDrive Standalone sync app to receive delayed updates.

Follow this guide to sync OneDrive on a Mac if you receive any of the following conditions:

• Error message:
  SharePoint Server 2019 OneDrive OneDrive for Business
  We're sorry that you're having trouble syncing your OneDrive.
  If you're having problems accessing OneDrive.com online, check the status of Microsoft Office Online Services at the Service Health portal.
• Error message:
  “Your account is currently unavailable' when trying to access OneDrive. Your account might have been temporarily blocked due to unusually large traffic volume, suspicious activity, or a violation of the Microsoft Services Agreement or code of conduct. To check your account status or reactivate your account, go to the OneDrive Account Activation page and follow the on-screen instructions.
• Can't see a network file:
  OneDrive for Business, make sure you have permissions to the file or folder you tried to add. Try to open the file or folder and make sure that you have permission to save a copy of it. If you are having problems seeing a file on a network, contact your network administrator.

If you can access your OneDrive online, try these steps to get sync running on your computer.

Note

Some instructions and links refer to Apple support. Microsoft is not responsible for any external content.

• Make sure the OneDrive process is running. To verify that OneDrive is running, look for the OneDrive icon on the right side of the menu bar. Or, you can check from Activity Monitor:

1. Open Activity Monitor from the Utilities folder in your Applications folder or use Spotlight to find it.
2. Choose the CPU tab, then look under the Process Column for OneDrive.
3. If OneDrive is not running, use Finder or Spotlight to start OneDrive.
   

Note

Learn how to use Spotlight and Finder on your Mac.

• Restart OneDrive
  
  1. Click the OneDrive icon in the menu bar.
  2. Click Quit OneDrive.
  3. Use Spotlight to search for OneDrive and open it.
  4. Update the OneDrive sync app for Mac
     

Note

If you originally installed OneDrive using the standalone installer, OneDrive updates itself automatically without using the Mac App Store.
If you originally installed OneDrive from the Mac App Store, open the OneDrive app and check if there is an Update button showing in the app itself.
For more information on install and setup, read about how to Get started with the new OneDrive sync client on Mac OS X.

• Reset OneDrive
  1. Exit OneDrive.
  2. Find OneDrive in your Applications folder
  3. Right-click and select “Show packaged contents”
  4. Navigate into the Contents/Resources folder
  5. Double tap on command or ResetOneDriveStandaloneApp.command
  6. Start OneDrive and finish the setup process.
     

Note

When choosing location, remember to select the previous OneDrive syncing location. This means your files won’t be downloaded again if they haven’t changed.

• Make sure you have enough space.
  
  1. Check and compare the size of your OneDrive storage to the available disk space on your computer. If you don't have enough space on your OneDrive or your computer, you will have to move or delete some files, or reduce the number of files and folders.
  2. If you don't have enough space on your OneDrive, you can buy more storage, or delete some files and folders. Look to see the largest files on your OneDrive. If you don't have enough space on your computer, you can free up disk space by moving or deleting files. You can also download less by choosing which OneDrive folders to sync to your computer (see below).

Onedrive Macos App

More choices

• Make sure you're syncing the right folders
  
  1. When you first set up OneDrive, click Choose folders to sync. If you didn't do this when you set up OneDrive, you can do it in Preferences.
  2. If you have other files in your OneDrive online that you haven't synced, you won't see those files. You can choose which folders to include in Sync in the OneDrive General settings tab.

Note

• If you choose to sync only some items, new items you add to the OneDrive folder on your Mac will sync to OneDrive, but items you add to OneDrive from the website or other devices won't be synced to your Mac unless they are in the folders you chose to sync.
• You can't choose individual files you want to sync, and you can't choose to sync files or folders shared with you.
• If you choose to stop syncing folders on your Mac, they will be deleted from the OneDrive folder on that computer, but they will remain in OneDrive.

• Check your filenames

Make sure you don't have any illegal characters such as . ' * : < > ? / | included in the filenames you are trying to sync.

Note

Although the only restricted filename character in macOS is : (colon), please be aware of the full list of Invalid file names and file types in OneDrive, OneDrive for Business, and SharePoint.

• Make sure that none of the files you want to sync are larger than 50GB if you are signed in to a Microsoft account, or 15GB if you are signed in to a work or school account. If you see an error message such as 'This file is too big to upload' or 'Reduce the size of this file to upload to...', Control-click it or tap it using two fingers, then choose Compress from the shortcut menu.
• Make sure the entire file path, including the file name, contains fewer than 400 characters. An example of a file path: /Users/username/Desktop/Pictures/2017/Family
• Once the file path is shortened, start OneDrive again. (Use Spotlight to search for OneDrive and open it.)
• If the steps above haven't worked, then you may need to unlink, set up, or reinstall OneDrive.
• You won't lose files or data by disabling or uninstalling OneDrive on your computer. You can always access your files by signing in to OneDrive.com.
• Before you begin, make sure your computer has all the latest updates, then try these options.
  
  • Uninstall and reinstall the OneDrive app. Uninstalling the app will remove the app settings.
    • For apps downloaded from the Mac App Store: Click the Launchpad icon in the Dock, hold down an app’s icon until all the icons begin to jiggle, then click the app’s delete button. If an icon doesn’t have a delete button, it can’t be uninstalled in Launchpad.
    • Alternatively, just drag the OneDrive app to the Trash.

Download Onedrive For Mac

After you uninstall, you can download the latest version of the app or visit the Mac App Store.

Onedrive For Business Mac Os

Note

Onedrive Os X

For more information on install and setup, read about how to Get started with the new OneDrive sync client on Mac OS X.

Onedrive Mac Os App Installer

Related articles