Deploy Office 365 ProPlus from a local source
Follow the steps in this article to deploy Office 365 ProPlus to client computers from a shared folder on your network by using the Office Deployment Tool (ODT).
Before you begin
Make sure your users have local admin privileges on their client devices. If that is not the case, then you should use your standard deployment tools and processes to install Office.
This article is intended for administrators in enterprise environments working with hundreds or thousands of computers. If you want to install Office on a single device or small number of devices, we recommend reviewing Download and install or reinstall Office 365 or Office 2019 on your PC or Mac or Use the Office offline installer.
The steps in this article are based on the following best practices:
- Manage updates to Office automatically, without any adminstrative overhead. For more details, see Choose how to manage updates. (If you want to manage updates from a local source, you need to change the configuration files. For more details, see configuring updates).
- Build two Office installation packages: One package uses Semi-Annual Channel for 64-bit and the other uses Semi-Annual Channel (Targeted) for 64-bit. Each installation package includes all the core Office apps. If you want to deploy the 32-bit version of Office instead, you can select that option when creating the installation package. To deploy both versions, you create additional installation packages. For more details, see Define your source files.
- Deploy to two deployment groups: a pilot group that receives the Semi-Annual Channel (Targeted) and a broad group that receives the Semi-Annual Channel. For more details, see Choose your update channels.
You can customize these options to match the requirements for your organization, including deploying to more than two groups, changing update channels, and deploying Visio and Project. For more details, see Customize your deployment.
Step 1: Create shared folders for Office installation files
Because you're deploying Office 365 ProPlus from a local source, you have to create folders to store the Office installation files. You'll create one parent folder and two child folders, one for the pilot group, with the version of Office from Semi-Annual Channel (Targeted), and one for the broad group, with version of Office from Semi-Annual Channel. This structure is similar to the one that the Office Content Delivery Network (CDN) uses.
Create the following folders:
- \\Server\Share\O365: Stores the ODT and the configuration files that define how to download and deploy Office.
- \\Server\Share\O365\SACT: Stores the Office 365 ProPlus installation files from Semi-Annual Channel (Targeted).
- \\Server\Share\O365\SAC: Stores the Office 365 ProPlus installation files from Semi-Annual Channel.
These folders will include all the Office installation files you need to deploy.
- Assign Read permissions for your users. Installing Office from a shared folder requires only that the user have Read permission for that folder, so you should assign Read permission to everyone. For details about how to create shared folders and assign permissions, see Shared Folders
In this article, we have just one shared folder on the network, but many organizations make the Office installation files available from multiple locations. Using multiple locations can help improve availability and minimize the effect on network bandwidth. For example, if some of your users are located in a branch office, you can create a shared folder in the branch office. Those users can then install Office from the local network. You can use the Distributed File System (DFS) role service in Windows Server to create a network share that is replicated to multiple locations. For more information, see DFS Management.
Step 2: Download the Office Deployment Tool
Download the ODT from the Microsoft Download Center to \\Server\Share\O365. If you've already downloaded the ODT, make sure you have the latest version.
After downloading the file, run the self-extracting executable file, which contains the ODT executable (setup.exe) and a sample configuration file (configuration.xml).
Step 3: Create a configuration file for the pilot group
To download and deploy Office 365 ProPlus to the pilot group, you use a configuration file with the ODT. To create the configuration file, we recommend using the Office Customization Tool.
- Go to Office Customization Tool and configure the desired settings for your Office 365 installation. We recommend the following options:
- Products: Office 365 ProPlus. You can also include Visio and Project if you plan to deploy those apps.
- Update channel: Choose Semi-Annual Channel (Targeted) for the installation package for the pilot group
- Language: Include all the language packs you plan to deploy. We recommend selecting Match operating system to automatically install the same languages that are in use by the operating system and any user on the client device. We also recommend selecting Fallback to the CDN to use the Office CDN as a backup source for language packs.
- Installation: Select Local source, and type "\\Server\Share\O365\SACT" for the source path. Office will be downloaded to and then installed from \\server\share\O365\SACT on your network
- Updates: To update your client devices automatically, choose CDN and Automatically check for updates.
- Upgrades: Choose to automatically remove all previous MSI versions of Office. You can also choose to install the same language as any removed MSI versions of Office, but make sure to include those languages in your installation package.
- Additional properties: To silently install Office for your users, choose Off for the Display level and On for the Automatically accept the EULA.
- Application preferences: Define any Office settings you want to enable, including VBA macro notifications, default file locations, and default file formats
- When you complete the configuration, click Export in the upper right of the page, and then save the file as config-pilot-SACT.xml in the \\Server\Share\O365 folder.
For more details on how to use the Office Customization Tool, see Overview of the Office Customization Tool. For more information about the configuration options, see Configuration options for the Office Deployment Tool.
Note that the Office installation files and Office updates will come from Semi-Annual Channel (Targeted). For more details on the most recent version of Office based on the different update channels, see Release information for updates to Office 365 ProPlus.
Step 4: Create a configuration file for the broad group
Using the Office Customization Tool, create the configuration file for the broad group.
- Go to Office Customization Tool and configure the desired settings for your Office 365 installation. We recommend matching the same options as the pilot group in Step 3, except for the following changes:
- Update channel: Choose Semi-Annual Channel for the installation package for the pilot group
- Installation: Select Local source, and type "\\Server\Share\O365\SAC" for the source path. Office will be downloaded to and then installed from \\server\share\O365\SAC on your network
- When you complete the configuration, click Export in the upper right of the page, and then save the file as config-pilot-SAC.xml in the \\Server\Share\O365 folder.
This configuration file is used to download Office installation files and then deploy them to the broad group. The settings are exactly the same as the first configuration file, except the source path points to a different folder (SAC), and the update channel is set to Semi-Annual Channel ("Broad").
Step 5: Download the Office installation package for the pilot group
From a command prompt, run the ODT executable in download mode and with a reference to the configuration file for the pilot group:
\\server\share\O365\setup.exe /download \\server\share\O365\config-pilot-SACT.xml
The files should begin downloading immediately. After running the command, go to \\server\share\O365\SACT and look for an Office folder with the appropriate files in it.
Note that when you download Office to a folder that already contains that version of Office, the ODT will conserve your network bandwidth by downloading only the missing files. For example, if you use the ODT to download Office in English and German to a folder that already contains Office in English, only the German language pack will be downloaded.
If you run into problems, make sure you have the newest version of the ODT and make sure your configuration file and command reference the correct location. You can also troubleshoot issues by reviewing the log file in the %temp% and %windir%\temp directories.
Step 6: Download the Office installation package for the broad group
From a command prompt, run the ODT executable in download mode and with a reference to the configuration file for the broad group:
\\server\share\O365\setup.exe /download \\server\share\O365\config-broad-SAC.xml
The files should begin downloading immediately. After running the command, go to \\server\share\O365\SAC and look for an Office folder with the appropriate files in it.
Step 7: Deploy Office to the pilot group
To deploy Office, we'll provide commands that users can run from their client computers. The commands run the ODT in configure mode and with a reference to the appropriate configuration file, which defines which version of Office to install on the client computer. Users who run these commands must have local admin privileges on their computer and must have read permissions to the share (\\server\share\O365).
From the client computers for the pilot group, run the following command from a command prompt with admin privileges:
\\Server\Share\O365\setup.exe /configure \\Server\Share\O365\config-pilot-SACT.xml
Most organizations will use this command as part of a batch file, script, or other process that automates the deployment. In those cases, you can run the script under elevated permissions, so the users will not need to have admin privileges on their computers.
After running the command, the Office installation should start immediately. If you run into problems, make sure you have the newest version of the ODT and make sure your configuration file and command reference the correct location. You can also troubleshoot issues by reviewing the log file in the %temp% and %windir%\temp directories.
After Office has deployed to the pilot group, test Office in your environment, particularly with your hardware and device drivers. For more details, see Choose your update channels.
Step 8: Deploy Office to the broad group
After you've finished testing Office with the pilot group, you can deploy it to the broad group. To do so, run the following command from a command prompt with admin privileges:
\\Server\Share\O365\setup.exe /configure \\Server\Share\O365\config-broad-SAC.xml
This command is the same as the pilot group, except that it references the configuration file for the broad group.
After running the command, the Office installation should start immediately.
Customize your deployment
The steps in this article cover the standard best practice recommendations from Microsoft. This section covers the most common customizations to these best practices.
Build and deploy multiple packages to multiple deployment groups
If you want to deploy both the 32-bit and the 64-bit version of Office, you can create additional installation packages. (Two different architectures cannot be included in the same package.) For more details, see Define your source files.
Use different update channels for Office
With Office 365 ProPlus, you can control how frequently your users receive feature updates to their Office applications. To do so, you choose an update channel for your users. In this article, we recommend the Semi-Annual Channel (Targeted) for your pilot group and the Semi-Annual Channel for the rest of your organization. You can, however, choose the Monthly Channel, which provides users with the newest features of Office as soon as they're available. A single Office installation package can only include one type of channel, so each new channel requires an additional package. For more details, see Overview of update channels for Office 365 ProPlus.
Deploy Visio and Project alongside the core Office apps
To deploy Visio and Project with Office 365 ProPlus, you can inlude them as part of the Office application when building it in Configuration Manager. For more details on licensing and system requirements, see Deployment guide for Visio and Deployment guide for Project.
Send feedback about: