Accessing Zimbra Collaboration Server with Thunderbird: Difference between revisions

(27 intermediate revisions by 6 users not shown)
Line 1: Line 1:
With the Zimbra Collaboration Suite, you are able to access your email using Mozilla Thunderbird messaging and collaboration client. Optionally, you can view your Zimbra Calendar using the separate Lightning Add-on for Thunderbird.
{{BC|Community Sandbox}}
__FORCETOC__
<div class="col-md-12 ibox-content">
=Accessing Zimbra Collaboration with Thunderbird=
{{KB|{{Unsupported}}|{{ZCS 8.6}}|{{ZCS 8.5}}|{{ZCS 8.0}}|}}
{{WIP}}
<div class="col-md-9 ibox-content">
<div class="thumbnail img-thumbnail">https://wiki.zimbra.com/images/4/42/Thunderbird-imap-banner.png</div>
</div>
=Introduction=
With 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.
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=
=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/'' .
This guide assumes that you have already installed Thunderbird 2 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:
To access your email, you must have the following information:
* '''Your Zimbra email address and password'''.
* '''Your Zimbra email address and password'''.
* '''Incoming mail server'''. This is usually in the form of mail.domain.com.
* '''Incoming mail server'''. This is usually in the form of mail.domain.com.
Line 16: Line 24:


=Accessing your Zimbra Mail with Thunderbird=
=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 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====
====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'''.
<div class="thumbnail img-thumbnail">https://wiki.zimbra.com/images/a/aa/Thunderbird-imap-001.png</div><br/>
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:
<div class="thumbnail img-thumbnail">https://wiki.zimbra.com/images/a/ae/Thunderbird-imap-002.png</div><br/>


1. Go to '''File>New>Account'''. This will open the Account Wizard.
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'''
If you have just opened Thunderbird for the first time, the Account Wizard will automatically open.
<div class="thumbnail img-thumbnail">https://wiki.zimbra.com/images/b/b1/Thunderbird-imap-003.png</div><br/>
 
2. Select '''Email account''' in the New Account Setup dialog. Click '''Next'''.
 
:[[Image:TB_New_Account_Setup.png]]
 
3. 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'''.
 
:[[Image:TB_Identity.png]]
 
4. Select '''IMAP'''. Enter the name of your incoming server in the '''Incoming Server''' field. If this is your first time using Thunderbird, type the name of your outgoing server in the '''Outgoing Server (SMTP)''' field. Click '''Next'''.
 
'''''Note:''' By default, Thunderbird will not use a secure connection for your incoming and outgoing servers. If your servers require a secure connection, such as TLS or SSL, you must set this after you exit the Account Wizard. To change your secure connection setting, see [[Accessing Zimbra Collaboration Suite with Thunderbird#Changing Your Server Settings|Changing Your Server Settings]].''
 
'''''Note:''' If you have an existing outgoing server already set as a default, the Account Wizard will automatically use this information. You can change this after you have created your account. To change this setting to the correct outgoing server, see [[Accessing Zimbra Collaboration Suite with Thunderbird#Changing Your Server Settings|Changing Your Server Settings]].''
 
:[[Image:TB_Server_Information.png]]
 
5. Enter your incoming user name from your email address into the '''Incoming User Name''' field. If this is your first time using Thunderbird, enter your outgoing user name in the '''Outgoing User Name''' field. This is the first part of your Zimbra email address. For example, if your email address is '''john.doe@example.com''', your incoming user name is '''john.doe'''.
 
:[[Image:TB_User_Names.png]]
 
6. Enter the name you want to call this account in the '''Account Name''' field.
 
:[[Image:TB_Account_Name.png]]


7. Verify that the information displayed is correct. If any information is incorrect, select '''Back''' and update the information. When the account information is correct, click '''Finish'''.
4.- Verify that the information displayed is correct. If any information is incorrect, update the information. When the account information is correct, click '''Done'''.
 
<div class="thumbnail img-thumbnail">https://wiki.zimbra.com/images/6/69/Thunderbird-imap-004.png</div><br/>
:[[Image:TB_Congratulations.png]]


Your settings are saved, and the Account Wizard closes. You are now able to access your Zimbra Mail.
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 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.
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=
=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.


If your incoming server and outgoing server 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'''
<div class="thumbnail img-thumbnail">https://wiki.zimbra.com/images/3/37/Thunderbird-imap-005.png</div><br/>
2.- Select '''Server Settings''', which is located under your Zimbra email account profile, listed on the left. Your Server Settings are displayed.
<div class="thumbnail img-thumbnail">https://wiki.zimbra.com/images/a/a5/Thunderbird-imap-006.png</div><br/>
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 incoming mail server====
==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'''
<div class="thumbnail img-thumbnail">https://wiki.zimbra.com/images/3/37/Thunderbird-imap-005.png</div><br/>
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'''.
<div class="thumbnail img-thumbnail">https://wiki.zimbra.com/images/3/3f/Thunderbird-imap-007.png</div><br/>
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'''.
<div class="thumbnail img-thumbnail">https://wiki.zimbra.com/images/3/38/Thunderbird-imap-008.png</div><br/>
5.- Click '''OK''' to save your settings.


1. In Thunderbird, go to '''Tools>Account 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'''
<div class="thumbnail img-thumbnail">https://wiki.zimbra.com/images/3/37/Thunderbird-imap-005.png</div><br/>
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'''.
<div class="thumbnail img-thumbnail">https://wiki.zimbra.com/images/6/60/Thunderbird-imap-009.png</div><br/>
4.- In the SMTP Server dialog, enter the following information:
<div class="thumbnail img-thumbnail">https://wiki.zimbra.com/images/9/99/Thunderbird-imap-010.png</div><br/>
* '''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.


2. Select '''Server Settings''', which is located under your Zimbra email account profile, listed on the left. Your Server Settings are displayed.
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.
<div class="thumbnail img-thumbnail">https://wiki.zimbra.com/images/0/08/Thunderbird-imap-011.png</div><br/>
7.- Click '''OK'''.


:[[Image:TB_server_settings.png]]
==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'''
<div class="thumbnail img-thumbnail">https://wiki.zimbra.com/images/2/2f/Thunderbird-imap-012.png</div><br/>
2.- Subscribe to the proper Folders like '''Drafts, Junk, Sent''' and '''Trash'''.
<div class="thumbnail img-thumbnail">https://wiki.zimbra.com/images/c/c8/Thunderbird-imap-013.png</div><br/>
3.- Go back and then, go to '''Tools>Account Settings''' or '''right-click''' in your Email account and '''Settings'''
<div class="thumbnail img-thumbnail">https://wiki.zimbra.com/images/3/37/Thunderbird-imap-005.png</div><br/>
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)
<div class="thumbnail img-thumbnail">https://wiki.zimbra.com/images/6/6c/Thunderbird-imap-014.png</div><br/>
5.- Go now to '''Junk Settings''', and activate the option to move the Junk messages into the folder localted in the IMAP account.
<div class="thumbnail img-thumbnail">https://wiki.zimbra.com/images/6/6e/Thunderbird-imap-015.png</div><br/>
6.- Finally in '''Server Settings''', set your Trash Folder to point into your IMAP Trash folder.
<div class="thumbnail img-thumbnail">https://wiki.zimbra.com/images/c/ca/Thunderbird-imap-016.png</div><br/>


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.
===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'''
<div class="thumbnail img-thumbnail">https://wiki.zimbra.com/images/c/c5/Thunderbird-imap-017.png</div><br/>


4. Click '''OK''' to save your settings.
'''Junk Example'''
<div class="thumbnail img-thumbnail">https://wiki.zimbra.com/images/d/dd/Thunderbird-imap-018.png</div><br/>


====To change the secure connection settings for your outgoing mail server====
'''Trash Example'''
<div class="thumbnail img-thumbnail">https://wiki.zimbra.com/images/6/6a/Thunderbird-imap-019.png</div><br/>


1. In Thunderbird, go to '''Tools>Account Settings'''.
=Viewing your Zimbra Calendar using Lightning=
 
The following steps show you how to read your Zimbra Calendar with Thunderbird using the [https://www.mozilla.org/en-US/projects/calendar/ '''Lightning Add-on''']. These instructions assume that you have already installed Lightning 0.5 at least, [https://support.mozilla.org/en-US/kb/installing-lightning-thunderbird '''Thunderbird comes with Lightning since the version 38'''].
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.
==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:
:[[Image:TB_Account_Settings.png]]
* Create appointments
 
* Edit appointments created from the Web Client or another device
3. Select the outgoing server for your Zimbra email account, and click '''Edit'''.
* Delete appointments
 
* Move appointments
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 connectionClick '''OK'''.
* Dismiss appointments
 
* etc.
:[[Image:TB_SMTP_Server.png]]
===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:
5. Click '''OK''' to save your settings.
  https://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.
====To add an outgoing server to your Zimbra email account====
https://<USERNAME>:<PASSWORD>@zimbrahost.example.com/dav/<USERNAME>/Calendar
 
1. In Thunderbird, go to '''Tools>Account Settings'''.


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.
For example, this uses Calendar2:
<div class="thumbnail img-thumbnail">https://wiki.zimbra.com/images/a/a5/Thunderbird-caldav-001.png</div><br/>


:[[Image:TB_Account_Settings.png]]
===Thunderbird instructions===
* 1. Click on the '''Calendars''' tab, in the top left of your Thunderbird application.
<div class="thumbnail img-thumbnail">https://wiki.zimbra.com/images/4/4a/Thunderbird-caldav-002.png</div><br/>


3. Click '''Add'''.
* 2. Click right-click '''New'''. A Create New Calendar dialog will display.
<div class="thumbnail img-thumbnail">https://wiki.zimbra.com/images/9/9f/Thunderbird-caldav-003.png</div><br/>


4. In the SMTP Server dialog, enter the following information:
* 3. Select '''On the Network'''. Click '''Next'''.
* '''Description'''. Enter a name for your outgoing server.
<div class="thumbnail img-thumbnail">https://wiki.zimbra.com/images/4/4e/Thunderbird-caldav-004.png</div><br/>
* '''Server name'''. Enter the name of your outgoing server. This is usually in the form of smtp.domain.com
* '''Port'''. This is 25 by default. If your SMTP server has a different port number, enter it here.
* '''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'''.
* 4. Select '''CalDAV'''. In the '''Location''' field, enter the URL of your Zimbra Calendar, and click '''Next'''.
<div class="thumbnail img-thumbnail">https://wiki.zimbra.com/images/e/eb/Thunderbird-caldav-005.png</div><br/>


:[[Image:TB_SMTP_Server.png]]
* 5. Enter a name for your Zimbra Calendar in the '''Name''' field. Select a color for your Calendar, and click '''Next'''.
<div class="thumbnail img-thumbnail">https://wiki.zimbra.com/images/0/0a/Thunderbird-caldav-006.png</div><br/>


5. In the Account Settings dialog, select your Zimbra email account, located in the Settings list on the left.
* 6. Enter your username and password, if prompted.
<div class="thumbnail img-thumbnail">https://wiki.zimbra.com/images/6/62/Thunderbird-caldav-007.png</div><br/>


6. Select the Zimbra outgoing server from the '''Outgoing Server (SMTP)''' drop-down list in your Account Settings.
* 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.
<div class="thumbnail img-thumbnail">https://wiki.zimbra.com/images/7/74/Thunderbird-caldav-008.png</div><br/>


:[[Image:TB_Account_Settings_2.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:
<div class="thumbnail img-thumbnail">https://wiki.zimbra.com/images/a/a0/Thunderbird-share.png</div>


7. Click '''OK'''.
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:
<div class="thumbnail img-thumbnail">https://wiki.zimbra.com/images/7/7c/Thunderbird-tasks-008.png</div>


=Viewing your Zimbra Calendar using Lightning=
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
<div class="thumbnail img-thumbnail">https://wiki.zimbra.com/images/5/5a/Thunderbird-tasks-003.png</div>


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.
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.
<div class="thumbnail img-thumbnail">https://wiki.zimbra.com/images/b/b5/Thunderbird-tasks-004.png</div>


====To view your Zimbra Calendar using Lightning====
Edit then the new Tasks List with right-click > Properties and select Add share
<div class="thumbnail img-thumbnail">https://wiki.zimbra.com/images/6/66/Thunderbird-tasks-005.png</div>


'''''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.''
In the email field, select the Bob's emails address, and select the role you want for Bob, read-only or read-write.
<div class="thumbnail img-thumbnail">https://wiki.zimbra.com/images/3/3d/Thunderbird-tasks-006.png</div>


1. Open the Zimbra Web Client, and click on the '''Calendar''' tab.
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.
<div class="thumbnail img-thumbnail">https://wiki.zimbra.com/images/6/6f/Thunderbird-tasks-007.png</div>


2. Right click on '''Calendar''' in the Calendar List pane and select '''Share Calendar''' from the right-click menu.
===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:
<pre>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</pre>


==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.
The URL of your Calendar is located at the bottom of the Share Properties dialog. Write down or copy this URL.


Line 136: Line 193:
3. Open Thunderbird.
3. Open Thunderbird.


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


:[[Image:TB_Lightning_Pane.png]]
:[[Image:TB_Lightning_Pane.png]]


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


6. Select '''On the Network'''. Click '''Next'''.
6. Select '''On the Network'''. Click '''Next'''.
Line 154: Line 211:
:[[Image:TB_Customize_Your_Calendar.png]]
:[[Image:TB_Customize_Your_Calendar.png]]


9. Enter your username and password, if you are prompted.
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 ([[User:HenningSprang|HenningSprang]]):''
'''''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 ([[User:HenningSprang|HenningSprang]]):''
<pre>
<pre>
webcal://<USERNAME>:<PASSWORD>@zimbrahost.example.com/home/<USERNAME>/Calendar
webcal://<USERNAME>:<PASSWORD>@zimbrahost.example.com/home/<USERNAME>/Calendar
Line 162: Line 219:


10. Click '''Finish'''.
10. Click '''Finish'''.
=====Accessing your Zimbra Calendar using Lightning with CalDAV (Only works with ZCS 5.0+ and Lightning 0.8+)=====
As of some recent build of Lightning (v0.8+), and a recent build of Zimbra (v5.0+) you can also use CalDAV to connect. This appears to fix some problems with deleting events as well.
To use CalDAV, just follow the above steps but use a CalDAV URL of the below form:
<pre>http://<USERNAME>:<PASSWORD>@zimbrahost.example.com/dav/<USERNAME>/Calendar</pre>


=Feature Differences When Using Thunderbird=
=Feature Differences When Using Thunderbird=
Line 180: Line 230:
* 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.
* 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.


=Accessing your addressbook using CardBook=
A recent add-on available on the Thunderbird market allow your desktop client to connect to the DAV API of Zimbra and synchronize all the contacts.
First of all you need to [https://addons.mozilla.org/fr/thunderbird/addon/cardbook/ download] the extention on the market and follow the how to provided in order to activate and present the cardbood extention.
One done, click on "add addressbook".
You will start the wizard. In it the first window select the "on the network" option and then "next"
[[File:Thunderbird-Contact-01.png]]
On the second panel you will need to fill the different fileds according to your environment :
[[File:Thunderbird-Contact-02.png]]
*URL : https://ZIMBRA_SERVER/dav/USER@DOMAIN.TLD/Contacts
*Username : User@DOMAIN.TLD
*Password : YOUR_PASSWORD
You will need to validate the setting in order to finish the installation.
We have now our contacts synchronized with Thunderbird.
[[File:Thunderbird-Contact-03.png]]


{{Article_Footer|ZCS 4.5.7|10/10/2007}}
{{Article_Footer|ZCS 8.6, 8.5, 8.0.x, 7.0.x|10/10/2007}}


[[Category: Clients]]
[[Category: Clients]]
[[Category: Pending Certification]]
{{NeedSME|Jorge|SME2|Gayle B.}}

Revision as of 13:51, 19 September 2016

Accessing Zimbra Collaboration with Thunderbird

   KB 2255        Last updated on 2016-09-19  




0.00
(0 votes)
Thunderbird-imap-banner.png

Introduction

With 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:

https://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.

https://<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.

Accessing your addressbook using CardBook

A recent add-on available on the Thunderbird market allow your desktop client to connect to the DAV API of Zimbra and synchronize all the contacts.

First of all you need to download the extention on the market and follow the how to provided in order to activate and present the cardbood extention.

One done, click on "add addressbook". You will start the wizard. In it the first window select the "on the network" option and then "next"

Thunderbird-Contact-01.png

On the second panel you will need to fill the different fileds according to your environment :

Thunderbird-Contact-02.png

You will need to validate the setting in order to finish the installation.

We have now our contacts synchronized with Thunderbird.

Thunderbird-Contact-03.png

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: 2016-09-19



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 Gren Elliot
Jump to: navigation, search