Kontact is KDE's suite of personal management applications that provides integrated mail, calendaring, address book and task functionality.

Thanks to Shashwat Jolly's great work during GSoC 2020, there is now built-in support for EteSync in Kontact.

Installing the resource

The resource is currently merged into KDE's main repos and will be part of the next release. Until then, you can install the resource using pre-built packages, or alternatively, you can build it yourself from source.

Please head over to the community chat if you need help or are facing any problems.

Pre-built packages

Here is a list of unofficial pre-built packages. Do you know how to create packages for your favourite distro and would like to have it listed here? Please contact us.

  • Arch: install kdepim-runtime >= 20.12 and libetebase to use it.
  • Ubuntu/Debain/OpenSUSE: PPA on OBS
  • Fedora/CentOS (COPR):
    • dnf copr enable daftaupe/etesync-rs
    • dnf install kdepim-runtime-etesync

Build from source

Please follow this guide to build and install the resource.

Adding your EteSync account to Kontact

Note: The below steps assume that you already have an EteSync account. If not, head over to the EteSync website to create one, and you're good to go!

  1. Open the calendar app in Kontact (called Korganizer).
  2. On the left, you'll see a list of all your calendars. Right click and select "Add Calendar".
  3. A dialog box will pop up, asking you to select the service you want. Select "EteSync Groupware Resource".

  4. A configuration dialog will appear:

    If you've already setup an EteSync encryption password:

    • Enter your EteSync username/email and password and click "Next".
    • Enter your EteSync encryption password and click "Finish".

    If you have a new EteSync account:

    • Enter your EteSync username/email and password and click "Next".
    • In the page that opens, you have to set your EteSync encryption password. This is used to encrypt/decrypt all your data, so make sure you double check it, as it cannot be changed if wrong.
    • Enter your EteSync encryption password and click "Finish".
    • Your account will be initialized with three default journals - "My Calendar", "My Contacts" and "My Tasks". Feel free to add more journals as you wish!

Advanced: If you have a self-hosted EteSync server

EteSync is completely open-source and so, you can host your own EteSync server if you prefer to do so. Thanks to the way EteSync is designed, there is very little benefit in running your own instance, however, if you still wish to do so, please follow the instructions.

After you have sucessfully set up your own instance, and verified it works by connecting to it from the browser, click on the "Advanced Settings" checkbox in the configuration dialog while setting up the resource. Enter the server URL of your self-hosted instance in the text-box that appears. Click on "Next" and follow the remaining steps as mentioned above.

For example, here's how to use a self-hosted server listening on http://localhost:8000:

Using EteSync with Kontact

You can now use the Kontact calendar and address book applications (KOrganizer and KAddressBook) to manage your EteSync calendars, tasks and contacts as you normally would.

Using these applications should be quite straight-forward, but KDE has a handbook on KOrganizer and KAddressBook if you wish to have a look.

Example usage:

That's it! If you have any more questions, or any changes to propose to this guide, do head over to the community chat and let us know. :)