Zimbra Desktop 2

Revision as of 08:19, 3 February 2010 by Jjzhuang (talk | contribs) (New page: == Read This Before Installing Zimbra Desktop == The latest version of Zimbra Desktop is 2.0 beta1 (build 10343). Please note that Zimbra Desktop is subject to Export Restrictions. ...)

(diff) ← Older revision | Latest revision (diff) | Newer revision → (diff)

Read This Before Installing Zimbra Desktop

The latest version of Zimbra Desktop is 2.0 beta1 (build 10343).

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 and Linux, do not run installer as the "root" user.
  • Run the installation wizard and follow the step-by-step instructions.

Using the Software

Accounts Setup

When you first launch Zimbra Desktop, you will need to setup 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 Suites (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 setup 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 setup all your accounts first, or setup one first and add others later. Once your accounts are setup, 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’ll find the Zimbra Desktop program under Start Menu. On Mac OS, it's located under /Applications/Zimbra Desktop. On Linux, there will be a shortcut place on Desktop.

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 Gamil

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

Known Issues

1. If folder message list is displayed by conversations (threads), replying to a message in conversation sometimes causes the conversation to disappear from the folder list view. This is a UI display issue and clicking on the current folder will bring the conversation back to view. Bug 30994

2. Network connectivity changes are not detected immediately. Rather they are only detected on the next attempt to sync. For accounts that are synced infrequently or not automatically at all, visual status does not timely reflect current network connectivity. Bug 21178

3. On Windows Vista, Zimbra Desktop can not be installed under %PROGRAMFILES% (e.g. C:\Program Files). %PROGRAMFILES% by default is read-only. Since Zimbra Desktop does not yet have separate locations for programs files and data files, when installed under %PROGRAMFILES%, some write operations on data files would fail. The workaround is to install Zimbra Desktop at the default location (\Users\<user name>\AppData\...), or directories user has write permission on.

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: 2010-02-03



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