Installation step by step

The guide will help you go through the most common scenarios for installation of the IceWarp Outlook Sync.

Required software

  • Microsoft Outlook 2016 or later

  • Microsoft Windows 10, 11 in 32bit or 64bit versions are supported

Note: Installer automatically detects Windows version. If the detected Windows version is older than Windows 7 with Service Pack 1, the installation will be aborted and you will see the error message.

Installer

You can find installation files on the IceWarp website.

  • The first step is to decide what installer to use. Do not install Outlook Sync via GPO, always prefer the .exe installer. It allows you to choose a type of installation and create a profile on demand.

  • For mass installations, use the .msi installer. You may start .msi under GPO to install Outlook Sync correctly and consistently across different Windows machines. Outlook Sync requires Outlook to be installed first. Client machines must have at least one account with administrator privileges, and .msi target must be able to invoke delegation. Outlook Sync .msi cannot be installed under the system account because that account does not have Microsoft Outlook available.

  • To run the installation using Command Prompt, see How to run installation with Command Prompt.

Single sign-on extension

Since version IceWarp Server 12.1.1, a new Outlook Sync SSO extension is available. It simplifies and automates the creation of a Microsoft Outlook profile by recognizing the server credentials. This extension is compatible with GPO and helps network administrators with the setup and configuration of the user's mailbox.

To enable SSO when installing .exe file, run the installator with the sso parameter.

Example:

installator full name.exe – sso

In our case:

outlook-sync-14.1.0.exe –sso

To enable SSO when installing .msi file, run the installator as follows.

Example:

msiexec /i installator full name.msi SMARTDISCOVER=sso

In our case:

msiexec /i outlook-sync-14.1.0.msi SMARTDISCOVER=sso

Note: You can download the new version of .msi file on IceWarp website in Apps.