How to configure IceWarp email accounts on Windows and macOS

Overview

This article explains how to configure IceWarp email accounts on Microsoft Windows and Apple macOS devices using supported email clients and protocols. It is intended for both server administrators and end-users who need to properly connect desktop email applications to IceWarp services.

The guide also clarifies protocol compatibility, limitations of Exchange ActiveSync (EAS), and when the IceWarp Outlook Sync (IceWarp Sync) add-on should be used.

Understanding Supported Connection Methods

IceWarp supports multiple communication protocols.

Important Limitation: Exchange ActiveSync (EAS)

Exchange ActiveSync is NOT Supported for Desktop Configuration.

Exchange ActiveSync (EAS) is primarily intended for mobile devices such as:

• Android smartphones
• iPhones and iPads

Modern desktop email clients on Windows and macOS do not provide reliable native EAS account configuration for IceWarp servers. 

Should you need to synchronize emails, contacts and calendars altogether, we recommend using the IceWarp Desktop Client.

What it means

Windows

• Microsoft Outlook cannot use native EAS connectivity with IceWarp.
• Windows Mail application support is inconsistent and not recommended.
• Outlook should use either:
  • IMAP/SMTP
  • IceWarp Outlook Sync

macOS

• Apple Mail does not support IceWarp EAS configuration.
• macOS clients should use:
  • IMAP/SMTP
  • CalDAV
  • CardDAV

When to use IceWarp Outlook Sync

Recommended Scenario

Use IceWarp Outlook Sync when:

• Users require full Microsoft Outlook collaboration features
• Synchronization of:
  • Email
  • Calendars
  • Contacts
  • Tasks
  • Notes
• Cached/offline Outlook mode is required
• Shared folders and Groupware functionality are needed

Compatible Outlook Versions

Outlook Sync is intended for Microsoft Outlook on Windows only.

Typically supported:

• Outlook 2021
• Outlook 2024
• Outlook 365

Outlook Sync Protocol Compatibility

When NOT to use Outlook Sync

Do not use Outlook Sync if:

• The user only needs basic email access
• Outlook is not installed
• The operating system is macOS and you have Outlook for Mac
• A lightweight IMAP-only configuration is preferred

Configuring Email on Windows

Option 1 — Microsoft Outlook with IMAP/SMTP

Recommended For

• Standard email usage
• Basic synchronization
• Non-Groupware environments

Required Settings

Incoming Mail Server (IMAP)

Outgoing Mail Server (SMTP)

Outlook Configuration Steps

1. Open Microsoft Outlook.
2. Select File → Add Account.
3. Enter the email address.
4. Choose Advanced Options.
5. Select Let me set up my account manually.
6. Choose IMAP.
7. Enter the server settings listed above.
8. Enter the account password.
9. Finish the configuration wizard.

Option 2 — Microsoft Outlook with IceWarp Outlook Sync

Recommended For

• Full collaboration functionality
• Shared calendars and contacts
• Enterprise deployments

Installation Steps

1. Download the IceWarp Outlook Sync installer from the IceWarp server or administrative portal.
2. Close Microsoft Outlook.
3. Run the installer with administrative permissions.
4. Open Outlook after installation.
5. Create a new IceWarp profile.
6. Enter:
   • Email address
   • Username
   • Password
   • Server hostname
7. Complete synchronization initialization.

Option 3 — IceWarp Desktop Client for Windows

Recommended For

• Users who want native IceWarp collaboration features
• Cross-platform deployments on both Windows and macOS
• Integrated email, calendar, contacts, chat, and conferencing
• Users who do not require Microsoft Outlook
• Simplified deployment with automatic account configuration

Protocol Compatibility

The IceWarp Desktop Client communicates directly with IceWarp services and does not require manual IMAP, POP3, CalDAV, or CardDAV configuration.

Important Notes

• The IceWarp Desktop Client does not use Exchange ActiveSync (EAS).
• No Outlook Sync add-on is required.
• The client is designed as a native alternative to traditional email applications.
• Smartdiscover may automatically configure server settings.

Installation Steps

1. Download the IceWarp Desktop Client from the IceWarp website.
2. Run the installer package.
3. Complete the installation wizard.
4. Launch the IceWarp Desktop Client.
5. Enter:
   • Email address
   • Password
6. If Smartdiscover is unavailable, manually specify the server hostname.
7. Complete the login process.

Configuring Email on macOS

Option 1 — Apple Mail with IMAP/SMTP

Recommended For

• Native macOS email access
• Standard email synchronization

Required Settings

Incoming Mail Server

Outgoing Mail Server

Apple Mail Configuration Steps

1. Open Mail.
2. Select Mail → Add Account.
3. Choose Other Mail Account.
4. Enter:
   • Name
   • Email address
   • Password
5. Select IMAP.
6. Enter incoming and outgoing server details.
7. Save the configuration.

Calendar and Contacts on macOS

macOS supports native synchronization using:

• CalDAV for calendars
• CardDAV for contacts

Recommended Configuration

Calendar (CalDAV)

1. Open System Settings → Internet Accounts.
2. Choose Add Other Account.
3. Select CalDAV Account.
4. Enter server credentials.

Contacts (CardDAV)

1. Open System Settings → Internet Accounts.
2. Choose Add Other Account.
3. Select CardDAV Account.
4. Enter server credentials.

Recommended Protocol Usage

Option 2 — IceWarp Desktop Client for Mac

Recommended For

• Users who want native IceWarp collaboration features
• Cross-platform deployments on both Windows and macOS
• Integrated email, calendar, contacts, chat, and conferencing
• Users who do not require Microsoft Outlook
• Simplified deployment with automatic account configuration

Protocol Compatibility

The IceWarp Desktop Client for Mac communicates directly with IceWarp services and does not require manual IMAP, POP3, CalDAV, or CardDAV configuration.

Installation Steps

1. Download the IceWarp Desktop Client for Mac from the IceWarp website.
2. Run the installer package.
3. Complete the installation wizard.
4. Launch the IceWarp Desktop Client for Mac.
5. Enter:
   • Email address
   • Password
6. If Smartdiscover is unavailable, manually specify the server hostname.
7. Complete the login process.

Troubleshooting

Authentication Failures

Verify:

• Username format
• Password correctness
• SMTP authentication enabled

SSL/TLS Errors

Check:

• Valid SSL certificate installed on server
• Correct hostname used in client configuration
• Proper encrypted ports selected

Mail Not Synchronizing

Verify:

• IMAP service enabled on IceWarp server
• Firewall allows required ports
• Antivirus software is not blocking connections

Outlook Sync Issues

Recommended actions:

• Use Clean Mailbox in IceWarp Sync Maintenance settings
• Recreate Outlook profile
• Reinstall IceWarp Sync add-on
• Verify Outlook version compatibility
• Check server-side licensing and permissions

Best Practices for Administrators

• Prefer IMAP over POP3
• Enforce SSL/TLS encryption
• Use IceWarp Sync or IceWarp Desktop Client only where Groupware functionality is required
• Avoid configuring desktop clients using Exchange ActiveSync
• Publish standardized configuration values for end-users
• Use Smartdiscover where available

Summary

For desktop operating systems:

• Exchange ActiveSync should not be used for Windows or macOS desktop email clients.
• Windows users requiring advanced Outlook collaboration should use IceWarp Outlook Sync or IceWarp Desktop Client.
• Standard email access should use IMAP/SMTP.
• macOS users should combine IMAP with CalDAV and CardDAV for full functionality or use IceWarp Desktop Client.

Proper protocol selection ensures stable synchronization of all items, improved compatibility, and easier troubleshooting for both administrators and end-users.