Zimbra Desktop 2

Zimbra Desktop 2

   KB 3358        Last updated on 2015-07-13  

(0 votes)

Read This Before Installing Zimbra Desktop

The latest version of Zimbra Desktop is 2.0.1 (build 10659). Release notes are available. You can download the installers from here: http://www.zimbra.com/downloads/zd-downloads.html.

Please note that Zimbra Desktop is subject to Export Restrictions.

Please refer to Zimbra Desktop FAQ to find information ranging from how to use the software to how to troubleshoot and report issues.

Hardware Requirements

At least 200MB free disk space is required to install the software. Additional disk space is required to download mailbox data.

At least 512MB free memory is required -- to run Zimbra Desktop.

The computer must have network connectivity at account setup. Network connectivity is also required to synchronize mailboxes with servers.

Platforms Supported

This release supports the following 3 platforms:

  • Windows XP SP2 and above, including all versions of Windows Vista and Windows 7
  • Mac OS X (Intel) Leopard 10.5.8 and above or Snow Leopard 10.6.2
  • Linux (x86) 2.6.x and above

NOTE: PowerPC based Mac OS is not supported.

Software Installation

Installation Instructions for First Time Users

  • Download the installer for the operating system of your choice.
  • Pre-installation:
    • Make sure the location where you install the software has enough disk space. If you plan to sync with large mailboxes, it is important to allocate enough space for all your mailbox data (the data will be saved under your home data directory).
    • Note, you must have sufficient access rights to install to the specified installation folder.
    • On Mac OS do not run installer as the "root" user.
    • On Linux, if you choose default install location and/or want to perform multi-user installation, please run installer as root. See Zimbra Desktop FAQ for more information.
  • Run the installation wizard and follow the step-by-step instructions. (In Linux, the installation wizard is the file install.pl, which will be found in the unpacked TGZ file. If you are logged in as root, click on the file and run in a terminal window. If you are not logged in as root, open a terminal window, navigate to the directory where the install.pl script is located, type sudo install.pl and then press <enter> and follow the prompts. Install.pl requires perl to run.

Using the Software

Accounts Setup

When you first launch Zimbra Desktop, you will need to set up one or more accounts. Zimbra Desktop supports the following account types:

  • Zimbra Account – You must have an existing account from an employer or a service provider that runs Zimbra Collaboration Suite (ZCS). ZCS 5.0 servers or above are required.
  • Gmail Account – You MUST first enable IMAP access from Gmail website.
  • Yahoo! Mail Account – Including @yahoo.com, @ymail.com, @rocketmail.com, and non-US yahoo domains.
  • Exchange IMAP Account – Your Exchange server must provide IMAP access. Only mail sync is supported.
  • Other POP/IMAP Accounts – You MUST have complete settings information in order to set up POP/IMAP access. Your can obtain such information from your service provider.

You can also set up more than one of the same type of accounts. For example, if you have two Zimbra accounts or two Gmail accounts, they can coexist without problems.

NOTE: You MUST have Internet access when setting up accounts, as Zimbra Desktop will need to verify your settings with your service providers.

You can either set up all your accounts first, or set up one first and add others later. Once your accounts are set up, click “Launch Zimbra Desktop” and start using the software. At any time when you want to add, update or remove accounts, simply click the “Setup” link (next to help) to go back to Account Setup screen.

NOTE: With large mailboxes or slow network connections, initial sync could take many hours. During initial sync, you will be still able to read, compose, send and receive new email. However you may not find all your messages in search results until the end of initial sync. It is OK if your network connection is interrupted or your computer crashes during initial sync. Zimbra Desktop will continue from the last check point when it resumes.

Startup and Shutdown

On Windows, you will find the Zimbra Desktop program in the Start menu. On Mac OS, it's located under /Applications/Zimbra Desktop. On Linux, there should be a shortcut placed the desktop. If not, log in as the applicable user, open a terminal window, sudo /opt/zimbra/zdesktop/linux/user-install.pl and follow the prompts. (Note: the command must be run under sudo, and will create the Desktop icon with root as the owner.) Be sure to run the file the first time by pressing <enter> at conclusion of the user install.

You can close the GUI client window any time. If you are in the middle of composing an email or have any unsaved changes, make sure to save them before closing the window.

Note that in addition to the GUI client, Zimbra Desktop also has a data engine responsible for synchronizing data with your remote accounts. The data engine will continue to run after you close the client window.

Special Note about Gmail

Gmail IMAP server lists all Gmail labels as folders. This includes both system labels such as “All Mail” and “Starred”, as well as user created labels. Because a single email can have multiple labels, as a result the same email can exist in multiple folders. To avoid downloading duplicate data, we ignore system label folders such as “All Mail” and “Starred”.

Going Offline

When you are disconnected from network or a remote server becomes unavailable, you are in offline mode. You can be in offline mode with a particular mailbox if only that server is temporarily down. When in offline mode, any data that is already downloaded is accessible. New updates to your remote mailbox including new emails will not be received until you are reconnected with that server. You will be able to compose and send emails while offline, but the outgoing emails will remain in the Outbox folder and will not be delivered until after you reconnect to the server.

If the network connectivity is lost while data synchronization with a remote server is under way, the process will resume where it was interrupted when connectivity recovers. No data will be lost due to connectivity disruption.

For more information please refer to Zimbra Desktop FAQ.

Source Code Information

Now available in the public perforce cache: Building_Zimbra_using_Perforce#Building_Zimbra_Desktop

Contact Information and Support

Please use Zimbra Desktop Forums to post your questions and comments about Zimbra Desktop. Support for this software application is provided only via Zimbra Desktop Forums.

Verified Against: unknown Date Created: 2/5/2010
Article ID: https://wiki.zimbra.com/index.php?title=Zimbra_Desktop_2 Date Modified: 2015-07-13

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