The OneDrive sync app update process

  • Article
  • 4 minutes to read

This commodity is for IT admins who manage the new OneDrive sync app (OneDrive.exe) in an enterprise environment. It explains how we release updates to the sync app for Windows and the standalone sync app for Mac through rings of validation, and how the sync app checks for updates. Annotation that if y'all deploy the sync app alongside Office (via the Function Deployment Tool or some other ways), it will proceed to cheque for updates contained of any Office update restrictions you set.

Notation

If you lot allow your users to sync personal OneDrive accounts, the update procedure described in this article and whatsoever settings you select use to all instances of the sync app.

The sync app installed from the Mac App Store follows a separate update procedure. After we cease rolling out updates within the Production ring, we publish them to the Mac App Store, where they're immediately released to anybody.

How we release updates through multiple rings

Later on we validate updates through rings within Microsoft, nosotros release them to the first public ring, Insiders. To endeavour these latest features, join the Windows Insider programme or the Office Insider program. It takes about three days to roll out to this ring. Later, we release to organizations in the default update ring, Production. We roll them out to a small percentage of users in the band at first, and slowly roll them out to everyone in the ring. This typically takes 1 to two weeks. At each increment along the way, we monitor telemetry for quality assurance purposes. In the rare example we detect an effect, nosotros suspend the release, accost the issue, and release a new update to users in the same society. After updates have completely rolled out within the Production ring, nosotros release them to the next ring, Deferred.

Release ring timeline

Important

We recommend selecting several people in your Information technology department as early adopters to join the Insiders ring and receive features early. Nosotros recommend leaving everyone else in the organization in the default Production ring to ensure they receive issues fixes and new features in a timely mode. Run across all our recommendations for configuring the sync app

The Deferred band provides builds that have been monitored throughout the Production rollout, so fewer releases are suspended. The Deferred band also lets you as an admin:

  • Command when you lot deploy updates (within 60 days of their release).

  • Deploy new versions from an internal network location to avoid using Internet bandwidth. (If you don't deploy an update later 60 days, it volition be automatically downloaded and installed.)

However, as the slowest ring, the Deferred ring receives functioning improvements, reliability fixes, and new features concluding.

Annotation

Microsoft reserves the correct to bypass the lx-twenty-four hours grace catamenia for critical updates.

To learn how to ready the Deferred ring for the Windows sync app using Group Policy, run into Gear up the sync app update ring. To acquire how to set it for the Mac sync app, see Configure the new OneDrive sync app on macOS. For info about the Microsoft 365 update process, meet Overview of update channels for Microsoft 365 Apps for enterprise. For info near the Windows 10 update process, meet Build deployment rings for Windows 10 updates.

How the sync app checks for and applies updates

The OneDrive sync app checks for available updates every 24 hours when it's running. If information technology has stopped and hasn't checked for updates in more than than 24 hours, the sync app will check for updates as soon as it'due south started. Windows ten also has a scheduled task that updates the sync app fifty-fifty when it's not running.

To determine if an update is available, the OneDrive sync app checks if:

  • The latest version released to the update ring is college than what's installed on the computer. If the installed version is also erstwhile to be updated to the electric current version, the sync app volition commencement be updated to the minimum version inside the ring.

  • The update is available to the computer based on the rollout percentage we set up within the ring.

If both of these are truthful, OneDrive downloads the update to a subconscious folder without whatsoever user interaction. Later on the download is complete, OneDrive verifies and installs information technology. If OneDrive is running, it'south stopped and then restarted. Users don't need to sign in again, and they don't need administrative rights to install the update.

For info nigh the latest releases, see New OneDrive sync app release notes.

Deploying updates in the Deferred ring

At any given time, the next planned Deferred ring release is published on the OneDrive sync app release notes page with a link to the corresponding installer and the target engagement when that version will be released. On the specified date, the "Rolling out" version for the Deferred ring becomes the new minimum. All sync apps below that version will automatically download the installer from the Net and update themselves.

To deploy an updated version of the sync app for Windows, run the post-obit control using Microsoft Endpoint Configuration Managing director:

              Execute <pathToExecutable>\OneDriveSetup.exe /update /restart

Where pathToExecutable is a location on the local reckoner or an accessible network share and OneDriveSetup.exe is the target version downloaded from the release notes page. Running this control restarts OneDrive.exe on all computers. If you don't want to restart the sync app, remove the /restart parameter. Run into Deploy using Microsoft Endpoint Configuration Director for tips on how to prepare the Microsoft Endpoint Configuration Manager deployment package.

To deploy an updated version of the sync app for Mac, deploy the OneDrive.pkg with the target version past using your MDM solution.