Skip to main content

Sync with Custom CalDAV (Fruux, Yahoo!, ownCloud, etc.)

2Do for Mac supports any CalDAV-compatible server. You can sync with a hosted service, your own server, or your company's CalDAV server.

Supported Servers​

iCal Server, ownCloud, Fruux, Oracle, Kerio, SabreDAV, and so on. In practice, 2Do works with any server that speaks CalDAV correctly, including:

  • Fruux (built-in)
  • Yahoo! Calendar (built-in)
  • ownCloud / Nextcloud
  • Synology Calendar (CalDAV)
  • Kerio Connect
  • Oracle Calendar
  • SabreDAV-based servers
  • Apple Calendar Server (iCal Server)
  • Fastmail and other CalDAV providers The iCloud option in 2Do's CalDAV picker is documented separately on Sync with iCloud.

What CalDAV Sync Carries​

  • All core task fields — title, notes, dates, recurrence, priority, action, location.
  • Multiple alarms per task can sync between 2Do devices through CalDAV.
  • Task attachments can sync up to one picture and one audio recording per task.
  • Tasks added to 2Do can appear in other CalDAV apps using the same account.

Limitations​

CalDAV does not have a place for every 2Do feature. 2Do can keep more detail between your 2Do devices than most CalDAV apps can show, but some 2Do-only structures are not carried by CalDAV at all:

  • List Groups, Tag Groups, Smart Lists, Search Presets
  • List color syncing may not be supported by some CalDAV servers.
  • Tags from 2Do don't appear in non-2Do CalDAV clients. They sync between 2Do devices, but only tags-in-use sync — unused tags don't carry across.
  • Paused state of a tag — re-pause on each device.
  • Files and links are better handled by Dropbox. CalDAV is best for standard task details, one picture, and one audio recording.
  • Repeating tasks sync as plain tasks to the CalDAV server, but they still repeat correctly between 2Do devices.
  • Projects and checklists appear as plain tasks in non-2Do CalDAV clients, but sync as projects and checklists between 2Do devices.
  • Some unusual repeating alert setups may not look exactly the same on the server.

Setup​

  1. Open 2Do > Settings > Sync.
  2. Select CalDAV as the sync method.
  3. Pick the server type:
  • Fruux or Yahoo! — built-in entries with auto-discovery.
  • CalDAV (the generic 3rd-party option, sometimes labelled Most 3rd party CalDAV Servers supported) — for ownCloud, Nextcloud, Synology, Kerio, etc.
  1. Enter your server URL (only required for the generic 3rd-party option), username, and password.
  2. Click Save / Connect. 2Do auto-discovers task collections on the server.
  3. Repeat on each device with the same credentials.

Fruux Setup​

  1. Settings > Sync → select Fruux.
  2. Generate an app-specific password at www.fruux.com.
  3. Enter your username and the app-specific password.

2Do auto-discovers the server and account paths — no manual URL entry required.

Generic 3rd-Party CalDAV Server​

For ownCloud, Nextcloud, Synology, Kerio, and similar:

  1. Settings > Sync → CalDAV → Custom CalDAV Server.
  2. Enter the server URL as your provider documents it (often the principal URL of your CalDAV account, e.g. https://your-server.example/remote.php/dav/principals/users/<user>/).
  3. Enter your username and password.
  4. Save. 2Do discovers your task collections.
After setup — your first sync

Close Settings and return to the main task list. Press ⌘S (or click the Sync toolbar button) to force the first sync. 2Do will then ask whether to Replace Server Data or Replace Local Data — choose carefully based on which side has the data you want to keep.

After the first sync, you can manually override the next sync any time under 2Do > Settings > Sync > Next Sync Action — pick Sync Normally, Replace Server (CalDAV) Data, or Replace Local Data before triggering the next sync. The setting auto-resets to Sync Normally afterwards.

Daily Sync​

Custom CalDAV syncs continuously while 2Do is running. Press ⌘S to force an immediate sync.

Common Issues​

Synology server compatibility​

Synology Calendar works with 2Do when you use the principal CalDAV URL provided by Synology Calendar.

301 Moved Permanently​

Some servers redirect the discovery URL. Update to the latest 2Do, which follows redirects automatically. If issues persist, enter the post-redirect URL directly.

Alarms shared via CalDAV shared lists don't sync​

Alarms attached to tasks on shared CalDAV lists don't always copy across, depending on the server's sharing rules. Re-add alarms locally if needed.

Multiple alerts on recurring tasks get removed​

Some CalDAV servers accept only a single alarm on repeating tasks. Use Dropbox sync if you rely heavily on multiple alarms per repeating task.

Setting Up Another Device & Troubleshooting​

  • Adding another device — install 2Do, point CalDAV at the exact same server URL and account credentials as your other devices, and let the first sync pull your data down. See Setting up a new device for the full walk-through.
  • One device showing different tasks? — see One of my devices isn't syncing correctly. Standard recovery: run a clean sync on the most up-to-date device, then Replace Local Data on the lagging ones.
  • Replace Server Data vs Replace Local Data — picking the wrong side can overwrite good data. Pause and read Replace Server Data vs Replace Local Data before confirming. You can re-trigger the choice any time under 2Do > Settings > Sync > Next Sync Action.

Tips​

tip

For self-hosters, Nextcloud + 2Do is a popular combination — your tasks live entirely on your own server.

tip

If your server requires app-specific passwords (Fruux, Yahoo!, anything with 2FA), generate one for 2Do specifically so you can revoke it later without changing your main account password.

Last updated on