Install Dynamics 365 for Outlook

To set up Dynamics 365 for Outlook on a user’s computer, you need to install the software, and then configure it. This topic describes how to set up and configure Dynamics 365 for Outlook, and also how to enable multi-factor authentication (MFA) through OAuth. Using MFA can help make client authentication more secure, especially for mobile users.

For information about installing Dynamics 365 for Outlook at a command prompt (silent installation), see Install Microsoft Dynamics 365 for Outlook using a Command Prompt.

For information about installing Dynamics 365 for Outlook using System Center Configuration Manager (SCCM), see the download Use SCCM to install Dynamics 365 for Outlook.

Important

  • You can’t install Dynamics 365 for Outlook on a computer running Microsoft Exchange Server.
  • Tracking activities is not supported when Dynamics 365 App for Outlook and Dynamics 365 for Outlook are used together by the same user.

Install Dynamics 365 for Outlook

You can add offline capability for the user either during this installation or at a later time.

Tip

If you encounter an issue installing, connecting, or enabling Dynamics 365 for Outlook with your Customer Engagement organization, use the Microsoft Support and Recovery Assistant to diagnose and fix the issue. You’ll need to sign in to the diagnostics tool with your Customer Engagement credentials.

  1. Meet the Dynamics 365 for Outlook requirements specified in Microsoft Dynamics 365 for Outlook hardware requirements and Dynamics 365 for Outlook support matrixes.

  2. Log on to the computer as a local administrator.

  3. Make sure that the latest Microsoft Office updates are installed, including all security updates. To verify, visit Microsoft Update.

  4. Locate and run the appropriate installation file by choosing one of the following methods:

  • To install from a DVD, double-click SetupClient.exe in the installation folder for the architecture (32-bit or 64-bit) of Microsoft Office that you’ve installed:

    • ... \Client\amd64 for 64-bit

    • ... \Client\i386 for 32-bit

  • To install from the Dynamics 365 for Customer Engagement web application:

    1. Click the Settings button Settings button., and then click Apps for Dynamics 365 apps.

    2. On the Apps for Dynamics 365 apps page, click Download from Microsoft Download Center.

    3. If you see any dialog boxes titled Security Warning, click Run in each.

    The Microsoft Dynamics 365 apps for Microsoft Office Outlook Setup wizard starts.

  1. On the License Agreement page, review the information. If you accept the license agreement, select I accept the license agreement, and then click Next.

  2. If the Get Recommended Updates page appears, indicate whether you want to obtain updates through the Microsoft Update program, and then click Next.

    Note

    Microsoft releases improvements to Dynamics 365 for Outlook as software updates. If you click Get Recommended Updates, those updates will be installed automatically. The exact level of automation, for example, whether any user interaction is required during the installation, is determined by the group policy of your organization.

  3. Click Install Now or Options.

    • To install Dynamics 365 for Outlook with offline capability, click Options, select Offline Capability on the Customize Installation page, and then click Install Now. Although offline capability lets you run Dynamics 365 for Customer Engagement without a network or Internet connection, it does require the installation of additional technologies and places more demand on your computer’s processor and memory. For more information about the minimum recommended requirements, see Microsoft Dynamics 365 for Outlook hardware requirements.

    • To install Dynamics 365 for Outlook without offline capability, click Install Now.

    Important

    If you don’t install offline capability at this point, the user will initially have no offline capability. If you click Install Now, the Outlook user can add offline capability later by clicking Go Offline in Outlook.

    The program features are installed and a progress indicator is displayed. You may be asked to restart your computer to complete the installation.

  4. On the completion page of the Microsoft Dynamics 365 apps for Microsoft Office Outlook Setup wizard, click Close.

Configure Dynamics 365 for Outlook

After Dynamics 365 for Outlook is installed, it must be configured. When you restart Outlook after you’ve installed Dynamics 365 for Outlook, the configuration wizard starts automatically.

Note

If you don’t want to configure Dynamics 365 for Outlook immediately after you install it, click Cancel. A Configure Microsoft Dynamics 365 for Outlook button then appears on the Outlook toolbar and will remain there until you configure Dynamics 365 for Outlook.

If the wizard doesn’t start automatically, you can start it as follows: On the Start screen, click Configuration Wizard or on earlier versions of Windows click Start > All Programs > Microsoft Dynamics 365 apps, and then click Configuration Wizard. Alternatively, click Configure Microsoft Dynamics 365 for Outlook on the Dynamics 365 apps tab in Outlook.

If you encounter an issue configuring Dynamics 365 for Outlook with your Customer Engagement organization, use the Microsoft Dynamics CRM for Outlook Configuration Diagnostic to fix the issue. You’ll need to sign in to the diagnostics tool with your Customer Engagement credentials.

  1. To add an organization, choose one of the following:

    • To connect to a Dynamics 365 for Customer Engagement organization, choose Dynamics 365 apps from the drop-down list.
  2. Click Connect.

    If you are prompted for credentials, select from the following options.

    • For a Dynamics 365 for Customer Engagement organization, enter your Microsoft Online Services user name and password, and then click OK. This information should have been sent to you in email when your account was added.
  3. Click Close.

  4. If you’re a member of more than one organization, restart the Configuration Wizard to designate a different organization as your current organization.

Enable multi-factor authentication through OAuth

In the Microsoft Dynamics 365 for Outlook Configuration Wizard, System Administrators can enable multi-factor authentication through the OAuth 2.0 Framework. OAuth 2.0 is an open framework for authorization that lets users provide access tokens, instead of credentials, to access data hosted by a given service provider (such as Dynamics 365 apps). Using MFA can help make client authentication more secure, especially for mobile users. Dynamics 365 apps versions of Dynamics 365 for Customer Engagement can take advantage of MFA.. Customer Engagement automatically uses OAuth.

If you have upgraded your authentication server to use OAuth prior to installing Dynamics 365 for Outlook, Dynamics 365 for Outlook will automatically check for and use OAuth for MFA. Users will see the OAuth sign-in form the first time they use Dynamics 365 for Outlook.

If you upgrade your authentication server to use OAuth after rolling out Dynamics 365 for Outlook, you have two options to set Dynamics 365 for Outlook to use OAuth.

  1. Reconfigure Dynamics 365 for Outlook on all computers. Run the Microsoft Dynamics 365 for Outlook Configuration Wizard and remove and re-add your organization.

    -- OR --

  2. Use Group Policy to update the following registration key:

    HKEY_CURRENT_USER\Software\Microsoft\MSCRMClient\{orgid}.

    Set AuthenticationProvider to 0

    After the registry change, Dynamics 365 for Outlook will automatically check for and use OAuth for MFA.

    In addition

    You might need to enable the following AD FS endpoint: /adfs/service/trust/13/windowstransport

    For information on enabling an endpoint, see Sign in to Microsoft 365, Azure, or Intune fails after you change the federation service endpoint.

See Also

Dynamics 365 for Outlook support Blog: Microsoft Dynamics CRM for Outlook Configuration Diagnostic Deploy Microsoft Dynamics 365 for Outlook by using Group Policy