# Example: Installing MS Office 365 as a Custom App

1\. Download the [Office365 Deployment Tool](https://www.microsoft.com/en-us/download/details.aspx?id=49117).

2\. Create a **public share** with **read** **permissions** for **everyone**. See this [Microsoft support](https://support.microsoft.com/en-us/windows/file-sharing-over-a-network-in-windows-10-b58704b2-f53a-4b82-7bc1-80f9994725bf) article for help with this.

3\. On the machine with the share, copy the Deployment Tool to the folder and execute it. It will download **setup.exe** and some example configuration files for **Office365 x64/x86** and **Office 2019**. 

{% hint style="warning" %}
These files can be manually edited, but this is **not recommended**. 
{% endhint %}

4\. Use the Microsoft Office Deployment Configuration Tool page to create a customized configuration file: 

<https://config.office.com/deploymentsettings>

{% hint style="info" %}
This page will allow you to create a deeper level of customization for what products will be installed, what type of updating should be applied to the product automatically, and even customizations to the products themselves.&#x20;
{% endhint %}

5\. It is strongly recommended to configure a **log file path** for the installation process in case of any troubleshooting.

6\. Download the configuration file and leave a copy in the shared folder created in step 2.

7\. Run **setup.exe** to download the source files to the share location using a command prompt:

`<local path to share folder>\setup.exe /configure configuration_file.xml`

{% hint style="info" %}
This step may take some time to complete. The setup files are several gigabytes in size.
{% endhint %}

8\. In the Deploy Console, click on **Custom App**.

9\. Provide a **name** for the custom application to display in the Deploy Console.

10\. Enter in the source for the installer location under **Enter URL**: `\\server\sharename\setup.exe`

11\. Configure the architecture type desired.

12\. Under "**Install Command Line**", provide the remainder of the command to install Office: `/configure \\server\sharename\configuration_file.xml`

13\. Set the **timeout** value to be **60 minutes** at a minimum as the install may take some time when applied to several machines at once.

14\. Perform a test install against one of your machines.&#x20;

{% hint style="info" %}
The Office installation can fail if there are any Office components already installed on the machine. Consider running the Office Cleanup tool on your machines to remove any traces and provide the best chance for success.&#x20;
{% endhint %}

{% hint style="success" %}
Once the test installation completes, it should now be visible under **Custom Apps** in the Deploy Console. It is now ready to be pushed to other machines.
{% endhint %}


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.faronics.com/faronicsdeploy/application-management/install-uninstall-and-update-apps/install-application-s/install-external-application-s-custom-app/installing-ms-office-365.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.