Accessing Zimbra Collaboration Server with Thunderbird

Accessing Zimbra Collaboration with Thunderbird

   KB 2255        Last updated on 08/25/2015  




0.00
(0 votes)
 - This article is a Community contribution and may include unsupported customizations.
 - This article is a Work in Progress, and may be unfinished or missing sections.
Thunderbird-imap-banner.png

Introduction

With the Zimbra Collaboration Server, you are able to access your email using the Mozilla Thunderbird messaging and collaboration client. Optionally, you can view your Zimbra Calendar using the separate Lightning Add-on for Thunderbird.

This guide shows you how to access to your Zimbra Mail and Calendar using Thunderbird 2 with the Lightning 0.5 Add-On.

Before You Begin

This guide assumes that you have already installed Thunderbird and, optionally, have already installed the Lightning Add-on. For more information on downloading and installing this software, go to Mozilla's Thunderbird page, http://www.mozilla.com/en-US/thunderbird/ .

To access your email, you must have the following information:

  • Your Zimbra email address and password.
  • Incoming mail server. This is usually in the form of mail.domain.com.
  • Outgoing mail server (SMTP). This is usually in the form of smtp.domain.com.

Your system administrator will be able to give you this information if you do not already have it.

Accessing your Zimbra Mail with Thunderbird

To access your Zimbra Mail, you must first create an account in Thunderbird. The following steps guide you through setting up a new account in Thunderbird.

To create a new account in Thunderbird

1.- Go to File > New > Account. This will open the Account Wizard. If you have just opened Thunderbird for the first time, the Account Wizard will automatically open. Enter the name you want to appear in the From field of your outgoing emails in the Your Name field. Enter your Zimbra email address into the Email Address field. Click Next.

Thunderbird-imap-001.png

2.- Thunderbird will try to get the Autodiscover information using some different technologies, after a few seconds Thunderbird will prompt with some Autodiscover information, if the data is not what you expect, you mus click in the Manual config button:

Thunderbird-imap-002.png

3.- Select IMAP o POP3 for the Incoming Email, you must be change the Server Hostname with your correct information. Introduce the SMTP Server Hostname as well. Zimbra recommends always use secure channels, so you can select SSL for both, IMAP/POP3 and SMTP. Note:' By default, Thunderbird will use a secure connection for your incoming and outgoing servers using TLS. If your servers require a secure connection, such as SSL, you must set this after you exit the Account Wizard. To change your secure connection setting

Thunderbird-imap-003.png

4.- Verify that the information displayed is correct. If any information is incorrect, update the information. When the account information is correct, click Done.

Thunderbird-imap-004.png

Your settings are saved, and the Account Wizard closes. You are now able to access your Zimbra Mail.

If your incoming server and outgoing server use not secure connections, you will need to configure this before you are able to access your mail. Additionally, if you did not specify an outgoing server when you were setting up your Zimbra email account, you will not be able to send outgoing messages yet. See the next section in order to change your server settings.

Changing Your Server Settings

If your incoming server and outgoing server doesn't use secure connections, you will need to configure this before you are able to access your mail. Additionally, if your Outgoing Server (SMTP) is not set to the correct server, you will not be able to send outgoing messages. Use the following directions to change your server settings.

To change the secure connection settings for your incoming mail server

1.- In Thunderbird, go to Tools>Account Settings or right-click in your Email account and Settings

Thunderbird-imap-005.png

2.- Select Server Settings, which is located under your Zimbra email account profile, listed on the left. Your Server Settings are displayed.

Thunderbird-imap-006.png

3.- Under Security Settings, select whether to use TLS if available, TLS, or SSL. Select Never if you do not want to use a secure connection. Select whether to use secure authentication. 4.- Click OK to save your settings.

To change the secure connection settings for your outgoing mail server

1.- In Thunderbird, go to Tools>Account Settings or right-click in your Email account and Settings

Thunderbird-imap-005.png

2.- Select Outgoing Server (SMTP), which is located at the bottom of the Settings list on the left. Your Outgoing Server (SMTP) Settings are displayed. 3.- Select the outgoing server for your Zimbra email account, and click Edit.

Thunderbird-imap-007.png

4.- In the SMTP Server dialog, under Security and Authentication, select whether to use TLS if available, TLS, or SSL. Select No if you do not want to use a secure connection. Click OK.

Thunderbird-imap-008.png

5.- Click OK to save your settings.

To add an outgoing server to your Zimbra email account

1.- In Thunderbird, go to Tools>Account Settings or right-click in your Email account and Settings

Thunderbird-imap-005.png

2.- Select Outgoing Server (SMTP), which is located at the bottom of the Settings list on the left. Your Outgoing Server (SMTP) Settings are displayed. 3.- Click Add.

Thunderbird-imap-009.png

4.- In the SMTP Server dialog, enter the following information:

Thunderbird-imap-010.png

  • Description. Enter a name for your outgoing server.
  • Server name. Enter the name of your outgoing server. This is usually in the form of smtp.domain.com
  • Port. This is 465 by default. If your SMTP server has a different port number, enter it here. Non secure connections needs to select port 25.
  • User Name. Enter your Zimbra email account user name.
  • Secure Connection. Select whether to use TLS if available, TLS, or SSL. Select No if you do not want to use a secure connection.

Click OK. 5.- In the Account Settings dialog, select your Zimbra email account, located in the Settings list on the left. 6.- Select the Zimbra outgoing server from the Outgoing Server (SMTP) drop-down list in your Account Settings.

Thunderbird-imap-011.png

7.- Click OK.

Configure Thunderbird to use IMAP properly

Wehn you use IMAP, you might want to have all the Drafts, Sent messages, Junk, and Trash folders fully synced between your Zimbra account and your Thunderbird Client. This steps shows you how to configure it properly. 1.- The first step is Subscribe to the proper IMAP Folders, press right-click in your Email account name, and select Subscribe

Thunderbird-imap-012.png

2.- Subscribe to the proper Folders like Drafts, Junk, Sent and Trash.

Thunderbird-imap-013.png

3.- Go back and then, go to Tools>Account Settings or right-click in your Email account and Settings

Thunderbird-imap-005.png

4.- Go to Copies & Folders and then select where you want to save your Sent emails, your Drafts as well as your templates (you can use the Drafts folder in the Zimbra server)

Thunderbird-imap-014.png

5.- Go now to Junk Settings, and activate the option to move the Junk messages into the folder localted in the IMAP account.

Thunderbird-imap-015.png

6.- Finally in Server Settings, set your Trash Folder to point into your IMAP Trash folder.

Thunderbird-imap-016.png

Examples

You will be able to see the same messages now in your Thunderbird as well in your Web Client inside the Sent, Junk, Drafts and Trash folders: Sent Example

Thunderbird-imap-017.png

Junk Example

Thunderbird-imap-018.png

Trash Example

Thunderbird-imap-019.png

Viewing your Zimbra Calendar using Lightning

The following steps show you how to read your Zimbra Calendar with Thunderbird using the Lightning Add-on. These instructions assume that you have already installed Lightning 0.5 at least, Thunderbird comes with Lightning since the version 38.

To view your Zimbra Calendar using Lightning and CalDAV

The recommended way to connect your Zimbra Calendar and Thunderbird is using Lightning and CalDAV. You will be able to do all the typical actions in a Calendar, and you will synchronize with your Zimbra Server, as follows:

  • Create appointments
  • Edit appointments created from the Web Client or another device
  • Delete appointments
  • Move appointments
  • Dismiss appointments
  • etc.

Zimbra Calendar and requirements

Since Zimbra Collaboration 6, you don't need any additional step or configuration in your server. You need to know the Calendar name that you want to use in the CalDAV client. The final URL to use in the CalDAV client would be:

http://zimbra.example.com/dav/<USERNAME>/CalendarNAME

You can also add your credentials into the URL. Note that this includes your password, which may not be recommended.

http://<USERNAME>:<PASSWORD>@zimbrahost.example.com/dav/<USERNAME>/Calendar

For example, this uses Calendar2:

Thunderbird-caldav-001.png

Thunderbird instructions

  • 1. Click on the Calendars tab, in the top left of your Thunderbird application.
Thunderbird-caldav-002.png

  • 2. Click right-click New. A Create New Calendar dialog will display.
Thunderbird-caldav-003.png

  • 3. Select On the Network. Click Next.
Thunderbird-caldav-004.png

  • 4. Select CalDAV. In the Location field, enter the URL of your Zimbra Calendar, and click Next.
Thunderbird-caldav-005.png

  • 5. Enter a name for your Zimbra Calendar in the Name field. Select a color for your Calendar, and click Next.
Thunderbird-caldav-006.png

  • 6. Enter your username and password, if prompted.
Thunderbird-caldav-007.png

  • 7. You will be able to see all the Appointments in your Zimbra Web Client, and you will be able to edit them, delete them, etc.
Thunderbird-caldav-008.png

Shared Calendar & Tasks in Thunderbird

You can use as well all the Zimbra sharing power with Thunderbird and CalDAV, for example: Imagine that you are the Responsible Person for one Department and you want to create a Calendar per each Technician, and a Tasks List, like in the next diagram:

Thunderbird-share.png

The Responsible must create each Calendar or Tasks List and share with the rest of Technicians, giving them the read-only or read-write permission. You must be careful with the location of the Calendars, or Tasks List, for example if you create the Tasks List called Technician Bob, inside your own Task List, the URL to share will be > https://zimbra.example.com/dav/RESPONSIBLEUSERNAME/Tasks/Technician%20Bob You can see here an example:

Thunderbird-tasks-008.png

In this example, the Responsible creates a Tasks List for Technician Bob, is the same procedure for Calendars as well. Go to the Responsible Tasks, and right-click > New Task List

Thunderbird-tasks-003.png

Then, write the name for the Tasks List, in this case Technician Bob, you will need later the %20 in the URL, if you can, it's much better to use - or _ instead space.

Thunderbird-tasks-004.png

Edit then the new Tasks List with right-click > Properties and select Add share

Thunderbird-tasks-005.png

In the email field, select the Bob's emails address, and select the role you want for Bob, read-only or read-write.

Thunderbird-tasks-006.png

Now, you can tell to Bob the URL that he must use to connect to the shared resources, Calendar, Tasks, etc. The URL will be the Responsible one, like https://zimbra.example.com/dav/RESPONSABLEUSERNAME/Tasks/Technician%20Bob even if the URL points to the Responsible, because Bob has access to that concrete resource, Bob just need to write his credentials when Thunderbird asks about them.

Thunderbird-tasks-007.png

Log trace when sync

When the appointments are pulled from the Zimbra Server to the CalDAV client, you will be able to see the next log traces in the /opt/zimbra/logs/mailbox.log. You can see that these came from Thunderbird with Lightning:

2015-08-06 13:48:03,704 INFO  [btpool0-14://zimbra86.zimbra.io/dav/admin/Calendar2/] [aname=admin@zimbra.io;ip=20.90.30.30;ua=Mozilla/5.0 (Windows NT 6.1;; WOW64;; rv:38.0) Gecko/20100101 Thunderbird/38.1.0 Lightning/4.0.1.2;] FileUploadServlet - saveUpload(): received Upload: { accountId=1def13c4-aea7-401d-9665-8007079a29c3, time=Thu Aug 06 13:48:03 EDT 2015, size=150, uploadId=8f67c628-d165-4efb-a8a9-b5fb75314939:7c78f0c6-fda4-4d1e-b4f6-705f7dd8a0e5, name=null, path=null }
2015-08-06 13:48:03,720 INFO  [btpool0-14://zimbra86.zimbra.io/dav/admin/Calendar2/] [name=admin;aname=admin@zimbra.io;ip=20.90.30.30;ua=Mozilla/5.0 (Windows NT 6.1;; WOW64;; rv:38.0) Gecko/20100101 Thunderbird/38.1.0 Lightning/4.0.1.2;] dav - DavServlet operation PROPFIND to /home/admin/Calendar2/ (depth: zero) finished in 18ms
2015-08-06 13:48:03,763 INFO  [btpool0-14://zimbra86.zimbra.io/dav/admin/Calendar2/] [aname=admin@zimbra.io;ip=20.90.30.30;ua=Mozilla/5.0 (Windows NT 6.1;; WOW64;; rv:38.0) Gecko/20100101 Thunderbird/38.1.0 Lightning/4.0.1.2;] FileUploadServlet - saveUpload(): received Upload: { accountId=1def13c4-aea7-401d-9665-8007079a29c3, time=Thu Aug 06 13:48:03 EDT 2015, size=144, uploadId=8f67c628-d165-4efb-a8a9-b5fb75314939:1dd719a2-7648-4420-b74b-eafb337435df, name=null, path=null }
2015-08-06 13:48:03,787 INFO  [btpool0-14://zimbra86.zimbra.io/dav/admin/Calendar2/] [aname=admin@zimbra.io;ip=20.90.30.30;ua=Mozilla/5.0 (Windows NT 6.1;; WOW64;; rv:38.0) Gecko/20100101 Thunderbird/38.1.0 Lightning/4.0.1.2;] dav - DavServlet operation PROPFIND to /home/admin/Calendar2/ (depth: one) finished in 25ms
2015-08-06 13:48:03,832 INFO  [btpool0-14://zimbra86.zimbra.io/dav/admin/Calendar2/] [aname=admin@zimbra.io;ip=20.90.30.30;ua=Mozilla/5.0 (Windows NT 6.1;; WOW64;; rv:38.0) Gecko/20100101 Thunderbird/38.1.0 Lightning/4.0.1.2;] FileUploadServlet - saveUpload(): received Upload: { accountId=1def13c4-aea7-401d-9665-8007079a29c3, time=Thu Aug 06 13:48:03 EDT 2015, size=262, uploadId=8f67c628-d165-4efb-a8a9-b5fb75314939:ebd1f398-f7a7-4530-bbc7-bd6292195163, name=null, path=null }
2015-08-06 13:48:03,845 INFO  [btpool0-14://zimbra86.zimbra.io/dav/admin/Calendar2/] [name=admin;aname=admin@zimbra.io;ip=20.90.30.30;ua=Mozilla/5.0 (Windows NT 6.1;; WOW64;; rv:38.0) Gecko/20100101 Thunderbird/38.1.0 Lightning/4.0.1.2;] dav - DavServlet operation REPORT to /home/admin/Calendar2/ (depth: one) finished in 14ms

Read-Only, not recommended - To view your Zimbra Calendar using Lightning and ICS

Note: These instructions will allow you to view your calendar using Thunderbird with the Lightning Add-on. You will not be able to create or edit appointments, meetings, or events. 1. Open the Zimbra Web Client, and click the Calendar tab. 2. Right click Calendar in the Calendar List pane, and select Share Calendar from the right-click menu. The URL of your Calendar is located at the bottom of the Share Properties dialog. Write down or copy this URL.

TB Share Properties.png

3. Open Thunderbird.

4. Click the Calendars tab in the lower left of your Thunderbird application.

TB Lightning Pane.png

5. Click New. A Create New Calendar dialog will display.

6. Select On the Network. Click Next.

TB Create New Calendar.png

7. Select iCalendar (ICS). In the Location field, enter the URL of your Zimbra Calendar. Click Next.

TB Locate Your Calendar.png

8. Enter a name for your Zimbra Calendar in the Name field. Then, select a color for your Calendar. Click Next.

TB Customize Your Calendar.png

9. Enter your username and password, if prompted.

Note: If you are not prompted, and access to the calendar fails, a workaround that I found is using a Calendar URL in this scheme - not elegant to put a password inside this URL; but the only way that worked for me (HenningSprang):

webcal://<USERNAME>:<PASSWORD>@zimbrahost.example.com/home/<USERNAME>/Calendar

10. Click Finish.

Feature Differences When Using Thunderbird

If you have used the Zimbra Web Client, note that the following features are different when using Thunderbird as a client.

  • To view mail folders that you have created using the Zimbra Web Client, you must subscribe to them.
  • Thunderbird may not always expunge deleted items or old drafts. These messages will be visible if you access your mail using Zimbra Web Client.
  • Lightning does not use notifications for upcoming events and meetings.
  • The Lightning Add-On may not automatically refresh your Zimbra Calendar. To see the most recent version of your Calendar, right-click and select Reload Remote Calendars .
  • Lightning only records a single set of authentication information for all remote calendars. If you have already set up access to another remote calendar using Lightning, you may encounter authentication errors when attempting to view your Zimbra calendar.


Verified Against: ZCS 8.6, 8.5, 8.0.x, 7.0.x Date Created: 10/10/2007
Article ID: https://wiki.zimbra.com/index.php?title=Accessing_Zimbra_Collaboration_Server_with_Thunderbird Date Modified: 08/25/2015



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 »

Wiki/KB reviewed by Jorge SME2 Gayle B. Last edit by Jorge de la Cruz Mingo
Jump to: navigation, search