MacOS instructions

Configuration

• OSX
  • CalDAV: Works. Setup instructions:
    • Internet Accounts->Add Other Account->CalDAV account
    • Account Type: Advanced
    • Username: your username
    • Password: the DAV password generated by etesync-dav
    • Server Address: localhost
    • Server Path: / or the path given in "Your DAV server" provided by etesync-dav
    • Port: 37358
    • Check "Use SSL"
  • CardDAV: Works. Setup instructions:
    • Internet Accounts->Add Other Account->CardDAV account
    • Account Type: Advanced
    • Username: your username
    • Password: the DAV password generated by etesync-dav
    • Server Address: https://localhost:37358 (please note it's https, not http!, also the difference in the Server Address compared to the CalDAV is necessary due to some os bug )
    • Server Path: / or the path given in "Your DAV server" provided by etesync-dav
    • Port: 37358
    • Check "Use SSL"

macOS Mojave (and later) bugs

macOS Mojave (and later) suffers from a bug that enforces the use of SSL, regardless of whether you enable the checkbox for SSL or not. So to use etesync-dav, you have to enable SSL.

NOTE: as reported by some users it seems like adding the certificate to the keychain doesn't always make it immediately usable. You may need to first add a CardDAV account (has to be CardDAV), accept the certificate, and only then you will be able to add a CalDAV account.

Setup SSL

Instructions differ depending on how you run etesync-dav. Most people will just need the first.

NOTE: After SSL is enabled you will need to access the webui through https:// instead of http://.

Webui

1. Login
2. Click on the "Setup SSL" button at the top and wait.
3. Enter your password once prompted by the system.
4. Restart etesync-dav

Command line tool

1. Login
2. Run etesync-dav certgen
3. Enter your password once prompted by the system.
4. Restart etesync-dav

Manual setup

Alternatively you can generate and configure a self-signed certificate manually with the following steps:

1. Generate a self-signed certificate (valid for 10 years)

cd ~/Library/Application\ Support/etesync-dav
openssl req -new -newkey rsa:4096 -days 3650 -nodes -x509 -subj "/CN=localhost" -keyout etesync.key -out etesync.crt

2. Using the open command triggers macOS's "add to keychain" dialog (equivelent of double-clicking that file in Finder):

open etesync.crt

3. In the dialog, confirm the addition of the certificate to the "login" keychain.

4. Open the Keychain Access app, then find and open localhost (under Keychains: login, Category: Certificates), expand "Trust" and pick "Always trust" for SSL.

5. Restart etesync-dav