Installation and Activation of EMS for Outlook – Microsoft 365

1. From the downloads portal, download Ems.Web.Addin.msi.

2. Run the .msi file on your application server.

3. Enter the full path for the installation location and click Next.

4. Enter your environment's Platform Services URL and the virtual directory name you want. Click Next.

5. Click Install. You might be asked to provide admin consent.

On-prem Customers

Option 1:

On-premises customers should follow the same process as cloud customers to connect to EMS's Entra App instance.

1. Download the Manifest: Use the following URLs:

   1. Sandbox Manifest: https://emsoutlookweb-zue-ua.emscloudservice.com/manifest

   2. Production Manifest: https://emsoutlookweb-zue-pr.emscloudservice.com/manifest

2. Whitelist the following IP addresses in your firewall based on your hosted region to connect to EMS Platform Services:

Option 2:

Create an Entra App.

1. Create an App Registration at your tenant in Microsoft Entra ID.

2. In the Authentication Menu, add the Single-page Application platform.

3. Add the following Redirect URIs:

   1. The URI of your app (for example, https://myaddress.com)

   2. A special URI to grant Outlook access: (for example, brk-multihub://myaddress.com)

4. Provide the MSI installer with the Application ID from the overview page.

5. Install Ems.Web.Addin.msi with the addition of the App Id in the Platform Service URL during installation.

6. Download the Manifest. Use the following URL:

   1. On-prem customers: https://<YourCompany>.com/EmsWebAddin/manifest.xml

   2. The manifest file is hosted at the installation directory of the web add-in: app_url/manifest.xml
      

We recommend enabling the EMS for Outlook – Microsoft 365 add-in for a small set of users first to test the add-in before enabling it for the entire team.

For End Users

1. Download the Manifest File:

   1. On-prem customers: https://<YourCompany>.com/EmsWebAddin/manifest.xml

   2. Cloud customers:

      1. Sandbox Manifest: https://emsoutlookweb-zue-ua.emscloudservice.com/manifest

      2. Production Manifest: https://emsoutlookweb-zue-pr.emscloudservice.com/manifest

2. Install the Add-in:

   1. Click https://aka.ms/olksideload to open Outlook add-in management.

   2. Click My add-ins.

   3. Click Add a custom add-in.

   4. Select Add from File....

   5. Upload the downloaded manifest file.

   6. Click Install. If Outlook shows a warning about adding a custom add-in, select Install to continue.

For a more detailed walk-through, follow the instructions for adding a custom add-in.

For Exchange Administrators (Enabling for Entire Organization)

1. Navigate to the Exchange Admin Center.

2. Select Organizations > Add-ins.

3. Click the plus sign.

4. Select Add from URL.

5. Enter the manifest.xml URL for your virtual directory:

   1. On-prem customers: https://<YourCompany>.com/EmsWebAddin/manifest.xml

   2. Cloud customers:

      1. Sandbox Manifest: https://emsoutlookweb-zue-ua.emscloudservice.com/manifest

      2. Production Manifest: https://emsoutlookweb-zue-pr.emscloudservice.com/manifest

6. Click Install.

Customers utilizing the EMS Entra App

Action Required:

• Uninstall and reinstall the manifest file for version 225.1.1. You won't need to reinstall the manifest file for future updates.

• Work with Professional Services or Support to provide allowable domains for EMS for Outlook web add-in connection.