Configure the new OneDrive sync client on macOS

Last updated: September 2017

This article is for IT administrators managing OneDrive for Business settings in work or school environments. If you're not an IT administrator, read Get started with the new OneDrive sync client on macOS.

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

Use the following keys to preconfigure or change settings for your users. The keys are the same whether you run the store edition or the standalone edition of the sync client, but the property list file name and domain name will be different. When you apply the settings, make sure to target the appropriate domain depending on the edition of the sync client.

Standalone

Mac App Store

PList Location

~/Library/Preferences/com.microsoft.OneDrive.plist

~/Library/Containers/com.microsoft.OneDrive-mac/Data/Library/Preferences/com.microsoft.OneDrive-mac.plist

Domain

com.microsoft.OneDrive

com.microsoft.OneDrive-mac

Deploy the sync client settings

Deploy the settings on macOS in the typical way:

  1. Quit the OneDrive application.

  2. Define the settings you want to change by creating a Plist 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

The following table lists all the settings that are currently exposed for the OneDrive sync client. You need to configure the parameters in parentheses.

Setting

Description

Parameters

Example Plist Entry

Disable personal accounts

Blocks users from signing in and syncing files in personal OneDrive accounts. If this key is set after a user has set up sync with a personal account, the user will be signed out.

DisablePersonalSync (Bool): When set to true, this parameter prevents users from adding or syncing personal accounts.

<key>DisablePersonalSync</key>
<(Bool)/>

Default folder location

Specifies the default location of the OneDrive folder for each tenant

TenantID (String): TenantID determines which accounts the default folder location setting should apply to. Find your Office 365 tenant ID

DefaultFolderPath (String): DefaultFolder specifies the default folder location.

Mac App Store:

The path must already exist when users set up the sync client.

Standalone:

The path will be created on users’ computers if it doesn’t already exist. Only with the Standalone sync client can you prevent users from changing the location.

<Key>Tenants</key>
<dict>
     <key>(TenantID)</key>
     <dict>
          <key>DefaultFolder</key>
          <string>(DefaultFolderPath)</string>
     </dict>
</dict>

Automatic upload bandwidth percentage

Enables the sync client to automatically set the amount of bandwidth used based on available bandwidth for uploading files

Bandwidth (int): This parameter determines the percentage of local upload bandwidth that the sync client can use. Accepted values are from 1 through 99.

<key>AutomaticUploadBandwidthPercentage</key>
<Int>(Bandwidth)</int>

Set maximum upload throughput

Sets the maximum upload throughput rate in kilobytes (KB)/sec for computers running the OneDrive sync client

KB/sec (int): This parameter determines the upload throughput in KB/sec that the sync client can use. The minimum rate is 50 KB/sec and the maximum rate is 100,000 KB/sec.

<key>UploadBandwidthLimited</key>
			<Int>(Upload Throughput Rate in KB/sec)</int>

Set maximum download
throughput

Sets the maximum download throughput rate in kilobytes (KB)/sec for computers running the OneDrive sync client

KB/sec (int): This parameter determines the download throughput in KB/sec that the sync client can use. The minimum rate is 50 KB/sec and the maximum rate is 100,000 KB/sec.

<key>DownloadBandwidthLimited</key>
			<Int>(Download Throughput Rate in KB/sec)</int>

Dock icon

Specifies whether a dock icon for OneDrive is shown

HideDockIcon (Bool): When set to true, this parameter hides the OneDrive dock icon even when the application is running.

<key>HideDockIcon</key>
<(Bool)/>

Open at login

Specifies whether OneDrive starts automatically when the user logs in

OpenAtLogin (Bool): When set to true, OneDrive will start automatically when the user logs in on the Mac.

<key>OpenAtLogin</key> 
<(Bool)/>

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

PList Location

~/Library/Preferences/com.microsoft.OneDriveUpdater.plist

Domain

com.microsoft.OneDriveUpdater

Setting

Description

Parameters

Example Plist Entry

Tier

Defines the update ring for the computer

UpdateRing (String): This parameter has two different values.

Production – The default update ring for OneDrive updates.

Enterprise – This update ring receives updates after they have rolled out through the Production ring. It also lets you control the deployment of updates. For more info about the update rings and how the sync client checks for updates, see The OneDrive sync client update process.

<key>Tier</key>
<string>(UpdateRing)</string>
 
Connect with an expert
Contact us
Expand your skills
Explore training

Was this information helpful?

Thank you for your feedback!

Thank you for your feedback! It sounds like it might be helpful to connect you to one of our Office support agents.

×