Zimbra Desktop 2
Read This Before Installing Zimbra Desktop
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.
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.
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.
Installation Instructions for First Time Users
- Download the installer for the operating system of your choice.
- 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
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 will find the Zimbra Desktop program in the Start menu. On Mac OS, it's located under /Applications/Zimbra Desktop. On Linux, there will be a shortcut placed the 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 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”.
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
1. When using Gmail or Yahoo! Mail with calendar sync enabled, occasionally a message deleted from Zimbra Desktop can reappear after the next sync cycle. Workaround is to disable calendar sync for Gmail or Yahoo! Mail until this issue is resolved. Bug 43171
2. If Zimbra Desktop is set as default mail client, clicking on a mailto link causes Zimbra Desktop to reload. Bug 44401
Contact Information and Support