How to Configure Gmail Account in Zimbra Client ?
To configure Gmail in Zimbra Desktop, download Zimbra Desktop, add a new account, select Gmail as the account type, enter your Gmail address and Google App Password, and click Validate and Save. You also need to enable IMAP in your Gmail settings first. The full setup takes about 5 minutes.
Zimbra is an open-source email client that handles email, contacts, calendars and notes in one interface. If you want to access your Gmail account from Zimbra Desktop without opening a browser, you can configure the two to work together in about 5 minutes. This guide covers every step, including the Gmail settings you need to change first before Zimbra can connect.
Before You Start: Gmail Settings to Enable
Before you can add Gmail to Zimbra, you need to make two changes in your Google account settings. Zimbra uses IMAP to connect to Gmail, and Google requires both IMAP and an app-specific password for third-party desktop clients.
Enable IMAP in Gmail
Log in to your Gmail account on the web. Go to Settings then See all settings. Click the Forwarding and POP/IMAP tab. Under IMAP access, select Enable IMAP. Scroll down and click Save Changes.

Create a Google App Password
Google does not let desktop clients sign in with your regular Gmail password unless you use an app-specific password. To create one, go to your Google Account settings, click Security, then under “How you sign in to Google” find App passwords. Select Mail as the app and Windows Computer as the device. Google generates a 16-character password that you use instead of your real password in Zimbra.
If you do not see the App passwords option, make sure 2-Step Verification is enabled on your Google Account. App passwords only appear when 2-Step Verification is active.
How to Configure Gmail in Zimbra Step by Step
Once your Gmail settings are ready, follow these steps to add Gmail to Zimbra Desktop.
Step 1: Download and install Zimbra Desktop on your Windows or Mac machine if you have not done so already.
Step 2: Launch Zimbra Desktop. On the welcome screen or in the Accounts settings, click Add New Account.
Step 3: Choose the account type. Select Gmail from the list. Zimbra will automatically fill in the IMAP server settings for Gmail.
Step 4: Enter your Gmail email address. In the Password field, enter the 16-character app-specific password you generated in your Google Account settings. Do not enter your regular Gmail password here.
Step 5: Click Validate and Save. Zimbra will connect to your Gmail account and verify the credentials. If successful, the account appears in the Zimbra sidebar.
Step 6: Zimbra will prompt you to sync your Gmail data. Click Launch Desktop to start syncing. Depending on the size of your inbox, the initial sync can take several minutes to several hours.
Once syncing is complete, your Gmail folders appear in the Zimbra left panel. You can read, reply and compose emails from Zimbra without opening a browser, and Zimbra will sync changes back to Gmail automatically when you are online.
How to Migrate Gmail Emails to Zimbra
If you want to move your Gmail emails into a standalone Zimbra installation rather than just connecting the two accounts, you need a migration tool. Turgs offers a dedicated Gmail to Zimbra Wizard that exports Gmail emails to the .tgz format that Zimbra uses for import.
Download Free Trial
Buy Full Version
The tool connects to your Gmail account, downloads all emails and folders and saves them as a Zimbra-compatible TGZ archive. You can then import that archive directly into Zimbra Server or Zimbra Desktop. This is useful if you are switching from Gmail to Zimbra as your primary email client and want to bring your complete email history with you.
The free trial exports the first 25 emails per folder. A full license is required for a complete migration. The tool also supports IMAP backup, Exchange Server backup, Yahoo Mail and Hotmail migration.
Why Use Zimbra Instead of Webmail?
Zimbra Desktop gives you several advantages over using Gmail in a browser. First, you can read and compose emails offline. Zimbra queues outgoing messages and sends them automatically when you reconnect. Second, Zimbra is a full personal information manager. It handles contacts, calendars, task lists and notes alongside email, all in one application. Third, your emails are stored locally, so you keep a working copy even if Google ever restricts access to your account.
The main trade-off is that Zimbra Desktop requires more setup than just opening a browser and signing in. The configuration steps above take about 5 minutes the first time, and the initial email sync can be slow for large inboxes. After that, the day-to-day experience is fast and reliable.
Limitations to Know
Limitations
- App password required: Google no longer allows less-secure app access. You must use a Google App Password to connect Zimbra. This requires 2-Step Verification to be enabled on your Google Account.
- Initial sync can be slow: A large Gmail inbox with tens of thousands of emails can take hours to sync the first time. Leave the sync running in the background.
- Zimbra Desktop is no longer actively maintained: The open-source Zimbra Desktop client reached end-of-life in recent years. It still works on many systems but does not receive security updates. For production use, consider Zimbra Collaboration Suite.
- Gmail labels map to folders: Gmail uses labels rather than traditional folders. In Zimbra, these appear as folders. The mapping is not always perfect for deeply nested label structures.
- Free trial export cap: The Gmail to Zimbra migration tool trial exports 25 emails per folder. A full license is needed for complete migrations.
Frequently Asked Questions
Why is Zimbra not connecting to my Gmail account?
The most common reason is that you are using your regular Gmail password instead of a Google App Password. Zimbra also requires IMAP to be enabled in your Gmail settings. Check both. If IMAP is on and you are using an app password but still cannot connect, check that your firewall or antivirus is not blocking outbound IMAP connections on port 993.
What is the difference between configuring Gmail in Zimbra and migrating Gmail to Zimbra?
Configuring Gmail in Zimbra means connecting the two so you can use your Gmail account from Zimbra Desktop while Gmail remains your primary email server. Migrating means moving your emails from Gmail to a standalone Zimbra server so Zimbra becomes your primary storage. The migration tool handles the second scenario by exporting Gmail emails to a Zimbra-compatible TGZ file.
Can I configure multiple Gmail accounts in one Zimbra installation?
Yes. Zimbra Desktop supports multiple accounts. For each Gmail account, repeat the Add New Account process and use a separate app password for each one. All accounts appear in the Zimbra sidebar and you can switch between them instantly.
Do I lose my Gmail emails when I configure Gmail in Zimbra?
No. Configuring Zimbra to connect to Gmail via IMAP does not delete anything from your Gmail account. Zimbra downloads copies of your emails. Your Gmail inbox on the web stays exactly as it was.
Which Zimbra file format is used for Gmail migration?
The Gmail to Zimbra Wizard exports emails to the TGZ format, which is the native import format for both Zimbra Desktop and Zimbra Collaboration Suite. You can import the TGZ file using the Zimbra Import/Export tool under Preferences in the Zimbra interface.
Is Zimbra Desktop free?
Yes, Zimbra Desktop is free and open source. The Zimbra Collaboration Suite has both open-source and commercial editions. For home and personal use, the free Zimbra Desktop client handles email, contacts and calendars without any cost. The Gmail to Zimbra migration tool has a free trial but requires a paid license for full migrations.