Skip to content

How to get started

John Bieling edited this page Jan 31, 2019 · 39 revisions

The TbSync add-on is listed on addons.thunderbird.net (a.k.a. ATN). To install the official version of TbSync, open Mozilla Thunderbird, go to the add-on page and search for TbSync. Install TbSync from the results list.

The official (stable) version might not be the latest release. To get the latest features, you may try the latest beta.

1. Open TbSync account manager

After the add-on has been installed successfully, the current status of the add-on is shown in the lower right corner of the main Thunderbird window. A single click on that status field will open the TbSync account manager.

TbSync Account Manager

Another option to open the TbSync account manager is via the Add-on Options menu or the Synchronization Settings menu entry.

2. Working with the TbSync account manager

There is not much to see until some accounts have been defined. Open the Account actions menu in the lower left corner to add a new account.

TbSync Account Manager

2.1 Adding an ActiveSync account

When adding an ActiveSync account, you will be prompted for the following details:

TbSync Account Manager

Choose any name to identify the new account, enter your user name (for ActiveSync that is probably an email address) and your password.

Note: Most ActiveSync servers support an automated configuration process called Autodiscover. If this is not working for your ActiveSync account then you'll have to select custom configuration and enter the server details by yourself.

2.2 Adding a CalDAV & CardDAV account

When adding a CalDAV & CardDAV account, you will be prompted to select a server type:

TbSync Account Manager, adding a DAV account

If your server does not have the discovery service configured, you need to select Manual configuration and provide the server addresses for your CalDAV and your CardDAV server. There are also a few pre-defined server configurations to simplify the setup process. The discovery service works for most self-hosted servers like ownCloud and Nextcloud and you usually only have to provide the base URL like cloud.mysever.com.

2.3 Optional settings

After the account has been created, it will look as follows:

TbSync Account Manager

Before enabling the account, you may check the settings and the available options, which should be self explanatory. An activated account will display a list of all resources available on your server:

TbSync Account Manager

TbSync supports contact folders, tasks folders and calendar folders.

The status of each folder will contain the name of the local synchronized item. In this example, the default calendar of the shown Outlook account has been synchronized to a Thunderbird calendar called Kalender (Outlook) and the default address book has been synchronized to a Thunderbird address book called Kontakte (Outlook). You are free to change these auto-generated names. If you delete one of these local items, they will be recreated during the next synchronization.

3. Keeping your account synchronized

At the moment, TbSync does not support push sync. Changes will only be synchronized, if you click on "Synchronize this account". However, you can enable AutoSync by settings up a sync interval in minutes. TbSync will then synchronize your account automatically.