Mobile Device Setup

Revision as of 22:11, 25 October 2010 by Garmanini (talk | contribs)

Admin Article

Article Information

This article applies to the following ZCS versions.

ZCS 6.0 Article ZCS 6.0 ZCS 5.0 Article ZCS 5.0 ZCS 4.5 Article ZCS 4.5

This article contains an overview of mobility options for Zimbra Collaboration Suite(ZCS), as well as information on how to set up Zimbra Mobile for most smartphones on specific operating systems. It also contains links to device-specific set-up pages, including information for the iPhone and Blackberry.

Zimbra Mobile Overview

Zimbra offers three options for accessing Zimbra accounts using mobile devices.

  • Zimbra Mobile Web Client. The first option, the Zimbra Mobile Web Client, is the most versatile option since it can be accessed on almost any mobile device and requires no license or additional software. Using the Zimbra Mobile Web Client, users can access their mail, contacts, calendar, and briefcase.
  • Zimbra Mobile for Smart Phones. The second option, Zimbra Mobile for Smart Phones, offers users two-way, over-the-air (OTA) synchronization and access to mail, contacts, calendar, and briefcase. This option only works for paid users of Zimbra Collaboration Suite. It works natively with iPhone, Android devices, Windows Mobile and Symbian S60/S80 smart phones.
    Note: In some instances, Zimbra Mobile for Smart Phones may work natively with a device, but the necessary sync plug-in is not bundled with the device. Plug-ins may be available via a third party, but may not be supported.
  • Zimbra Connector for BlackBerry. The third option, Zimbra Connector for BlackBerry, is only for BlackBerry mobile devices. This option offers users two-way, OTA synchronization and access to mail, contacts, calendar, and briefcase. This option requires a paid Zimbra Collaboration Suite license plus you must have a BlackBerry Enterprise Server (BES).

Accessing ZCS using Zimbra Mobile Web Client

All devices with an HTML-compatible browser can access Zimbra email, contacts, calendar, and briefcase using the Zimbra Mobile Web Client.

To use the Zimbra Mobile Web Client, open the HTML-compatible browser on your phone and type in the URL of your Zimbra Server with a /m/ at the end of the URL. For example:

Using Zimbra Mobile with iPhones

Entering Zimbra Mobile settings on your iPhone (or iPad/iTouch) will sync your email, contacts and calendars using your carrier's data plan. Note, in order to use this feature you need to be 1) using a Zimbra paid Network Edition account and 2) your administrator must have mobility enabled.


Performing these steps can delete all of the existing contacts on your iPhone. This is a common problem for iPhone users when creating a new ActiveSync account. You should ensure that you have backed up all of your contacts before proceeding.


First click on the "Settings" icon (the gears) and scroll down and select "Mail, Contacts, Calendars." On the next screen you will see and select "Add Account." Choose "Microsoft Exchange"

Next you will need to enter your account information:

  • Email. This is your company email address (eg
  • Password. This is your Zimbra password (the same on used for the Zimbra Web Client)
  • Description. A description for your Account


Once you have successfully set up your account, you should begin to see mail folders contacts and your calendar(s) appear on the device. After, you may choose to edit either global or account-specific settings.

Global settings available affect all your email accounts and is located in Settings / Mail, Contacts, Calendars. Here you can set usability controls such as number of messages, previews, font size and more.

Within this screen you may also select your Zimbra Account and then select "Account Info" to adjust whether you want any of the syncing options changed, how many days of email and which folders you want pushed.

You can find more information on the Next Wiki - Zimbra_Mobile_Installation_and_Setup_for_iPhone

Configuring Zimbra Mobile on Android SmartPhones

Android-based smartphones such as the Motorola Droid or HTC Evo will natively sync email, contacts and calendars to Zimbra accounts. The two pre-requisites to configure this are:

  1. The Zimbra email system used by your organization or service provider is a paid Network Edition license (ask your administrator if you are not sure)
  2. Your administrator has enabled mobility on your account

Assuming these two requirements are met, you configure Zimbra just like you would a Microsoft Exchange account on the device (this is the name used for any ActiveSync-based service).

In order to complete this set up you will need to know the following:

  • Your email address
  • Your email password
  • Your organization's domain you normally type in the web browser (eg "")
  • Does your organization require SSL access or not (eg do you use "http://" or "https://" to view Zimbra webmail)

Here are the basic steps:

1) From the Home screen, tap the gray Application button. 2) Tap Email. 3) Tap Next. 4) Using the keyboard, enter:

  • Your full email address
  • Your email password

5) Tap Next. 6) Tap Exchange account. 7) Complete the following fields, and then click Next.

         Your full email address preceded by a backslash
         (For example, \ Please note that some phones do not require the backslash.)
         Your email password
     Exchange Server  (same URL you use for Zimbra webmail)
     Use secure connection SSL
         (Ask your admin if this is optional)
     Accept all SSL certificates
         (Ask your admin if this is optional)

8) Select your desired Account options, and then tap Next. 9) Select your desired settings on Set up email, and then tap Done.

Here link to a common set up flow for devices:

Configuring Zimbra Mobile for Smart Phones on Windows Mobile Devices

Windows Mobile 6 and Windows Mobile 5

The following instructions are for configuring access to a ZCS account on a Windows Mobile 6 or Windows Mobile 5 device.

Note: Some users may experience configuration difficulty if using SSL with Windows Mobile 5. Windows Mobile 5 includes a limited number of root certificates and it may be necessary to install your server’s signing CA’s certificate on the device in order to use SSL.

Note: Zimbra Mobile must be enabled by a system administrator before a device can be configured.

  1. Select Start.
  2. Select ActiveSync.
  3. Choose to configure a new account:
    a. If no account is configured for ActiveSync, select the option to "Set up your device to sync with it" [the server].
    b.If you are replacing a pre-existing account, select Menu and then select "Configure Server".
  4. In the box for "Server address:", enter the publicly accessible hostname of the server (
  5. If the server requires SSL (that is, if the server's zimbraMailMode is either "https" or "mixed"), check the box for "This server requires an encrypted (SSL) connection". Note that Windows Mobile enforces strict verification of server certificates; if your zimbra server has the default self-signed certificate, you will not be able to use Zimbra Mobile unless you import the root certificate from the server into the device. See the link to the SSLChainSaver utility below.
  6. Select Next.
  7. In the "User name:" box, enter the username part of the email address ("bob" of "").
  8. In the "Password:" box, enter the password of the user ('s password).
  9. In the "Domain:" box, enter the domain part of the email address ("" of "").
  10. Check the "Save password" box.
  11. Select Next.
  12. Check the boxes for any combination of Contacts, Calendar, and E-mail. As of ZCS 4.5.6, Tasks do not sync through Zimbra Mobile; selecting Tasks will cause the device to not sync properly with the server.
  13. Select Finish.

The device is now configured. Select Sync to synchronize the selected items with the server.

Windows Mobile 2003

The following instructions are for configuring access to a ZCS account on a Windows Mobile 2003 device.

  1. Connect the device to your Windows PC.
  2. Open ActiveSync if it is not already running.
  3. Go to the Tools Menu > Configure Server Source.
  4. Put the FQDN of your Zimbra Server in the server source box.
  5. Put a check next to “this server requires a encrypted (SSL) connection” (if appropriate).
  6. Enter the full email address of the user as the username.
  7. Enter their password.
  8. Enter their mail domain as the domain name.
  9. Put a check next to save password (as desired).

The device is now configured. You must now import a certificate from the Zimbra Server to your mobile device in order for it to sync, or you will get an error about an invalid cert.

To import the SSL cert into the mobile device, use the following steps.

  1. Go to /opt/zimbra/ssl/zimbra/ca directory and copy your ca.pem file to a safe location. (Make sure this is the new certificate that you have created)
  2. Run this command on the file you copied
    $ openssl x509 -in ca.pem -inform PEM -out MyCertificatecrtcer -outform DER
  3. Copy the new MyCertificatecrt.cer file to your Windows Mobile device.
  4. Use your Windows Mobile device's File Manager to click on the MyCertificate.crt.cer file, you should receive a message that it was imported.
  5. Enable SSL in ActiveSync on your device.

Accessing ZCS using Zimbra Connector for BlackBerry

For information on configuring Zimbra Connector for BlackBerry(ZCB), see the ZCS Connector for Blackberry Guide. For more information on ZCB, including community articles and troubleshooting information, see Category:ZCB.

Community Articles for Accessing ZCS using Specific Devices

The following community articles include information on configuring specific devices. Some of these articles contain additional instructions for installing and configuring third-party mobile access. As community contributions, the instructions for installing and configuring third-party mobile access may not be supported for Network Edition customers.


Wiki Resources

The following categories and articles contain information on troubleshooting mobile issues.

Forum Support for Mobile Options/Issues

The following areas are available on the Zimbra Forums for discussing mobility options and issues.

Verified Against: Date Created: 11/7/2006
Article ID: Date Modified: 2010-10-25

Try Zimbra

Try Zimbra Collaboration with a 60-day free trial.
Get it now »

Want to get involved?

You can contribute in the Community, Wiki, Code, or development of Zimlets.
Find out more. »

Looking for a Video?

Visit our YouTube channel to get the latest webinars, technology news, product overviews, and so much more.
Go to the YouTube channel »

Jump to: navigation, search