Skip to main content

Sync with Custom CalDAV

Use CalDAV to sync 2Do with a service that supports CalDAV task collections. You can connect a hosted account or a server you manage. Support for calendar events alone does not establish support for tasks.

CalDAV sync works during Android's full-featured trial and requires 2Do Pro after the trial ends.

Supported Servers​

2Do offers built-in entries for Fruux, Yahoo!, and FastMail, plus Custom CalDAV Server for a provider's own task endpoint. Examples include ownCloud, Nextcloud, Synology Calendar, Kerio, and SabreDAV servers. Check the provider's current task support, account URL, and authentication requirements.

For Apple's service, see iCloud CalDAV. The recommended iCloud method is separate and does not use CalDAV.

Lists and Task Calendars​

A synced 2Do list is a task calendar on the CalDAV server. Creating, renaming, or deleting a synced list changes the matching task calendar. Collections created by other compatible apps can appear as lists in 2Do.

The other app must support CalDAV tasks and the fields you use. Apps can differ in how they show projects, checklists, repeats, or alerts.

What CalDAV Sync Carries​

Supported task fields include titles, notes, dates, alarms, repeats, priorities, tags, and project or checklist details that 2Do exchanges through CalDAV. Provider support affects which details other apps can display or retain.

Limitations​

  • List groups, tag groups, Smart Lists, and saved search rules do not sync through CalDAV.
  • Attachment sync represents up to one picture and one audio recording per task. It also depends on the server's attachment support.
  • A tag's paused state stays local.
  • Some servers do not preserve list colors, multiple alarms, or every repeat pattern.

If you need fuller 2Do data exchange between your own devices, see iCloud or Dropbox.

Setup​

  1. Open Settings > Sync setup > Sync Method.
  2. Choose Fruux, Yahoo!, or FastMail under CalDAV, or Custom CalDAV Server for another endpoint.
  3. Enter Username and Password under Credentials. Use an app-specific password if the provider requires one.
  4. For Custom CalDAV Server, also enter the provider's Server URL.
  5. Tap Sign in.
  6. Close Settings and pull down on the task list to sync. If asked how to begin, choose the copy to keep after reading replacement choices.

Use the same server and account on every device that should share the same tasks.

Fruux Setup​

Choose Fruux in Sync Method, then enter the account username and the password Fruux provides for third-party apps. Follow Fruux's account instructions for any app-specific password. Tap Sign in; the built-in entry handles discovery without a custom server URL.

Yahoo Setup​

Yahoo requires an app password for CalDAV. Generate one for 2Do in your Yahoo account's security settings; your normal Yahoo account password will not work for this connection.

  1. Follow Yahoo's app-password instructions to create a password for 2Do.
  2. In 2Do, open Settings > Sync setup > Sync Method and choose Yahoo! under CalDAV.
  3. Under Credentials, enter your full Yahoo email address in Username and the generated app password in Password, then tap Sign in.

Yahoo's documented CalDAV server is https://caldav.calendar.yahoo.com/. If sign-in fails, check Yahoo connection errors before changing server settings.

Custom CalDAV Server​

Choose Custom CalDAV Server and use the CalDAV account or principal URL documented by your provider. A website's ordinary home-page URL may not be its CalDAV endpoint. Check any port or secure-connection settings against that provider's instructions, then sign in with the account credentials.

Daily Sync​

Choose an interval under Sync automatically. Android may delay background work. Pull down on the task list to request a sync while the app is open.

Common Issues​

"Sync is a Pro feature" message​

The Android full-featured trial has ended. Syncing requires 2Do Pro, including for custom CalDAV accounts.

Yahoo connection errors​

For 401 Unauthorized, check that Username contains your full Yahoo email address and Password contains a Yahoo-generated app password. If Yahoo still rejects it, generate a new app password and enter it in 2Do.

In 2Do for Android 3.1.1 and some earlier versions, Operation is forbidden can also result from a connection setup bug that sends requests to Yahoo's public website. A fix is prepared for the next Android update. Changing the server address under Custom CalDAV Server uses the same affected setup and will not avoid this bug.

You can continue working offline while waiting for the update. If you need sync between 2Do apps sooner, Dropbox is an alternative, but it does not sync with Yahoo. Make a backup and check which device has your complete tasks before changing sync services.

Nextcloud connection errors​

For sign-in failures, 429 Too Many Requests, or problems connecting through a reverse proxy, see Nextcloud CalDAV connection problems.

301 Moved Permanently​

Check the provider's current CalDAV URL and use an up-to-date version of 2Do. A discovery redirect may lead to an ordinary web page instead of the DAV service. For Nextcloud, see discovery and reverse-proxy checks. If the failure continues, send the redirect error and 2Do's logs to support.

Multiple alerts on recurring tasks get removed​

Confirm that the server and the other app support those alerts. If you need multiple alarms across your own 2Do devices, consider iCloud sync, which does not depend on another task app's CalDAV representation.

Setting Up Another Device & Troubleshooting​

Connect the additional device to the same server and account. Choose Replace data on this device when the account contains the complete tasks. Before replacing local work, make a backup and keep a copy off the device.

Settings > Sync setup > Next sync action also offers Replace server data, which replaces the account's task data with this device's copy. Use it only deliberately; it affects your other connected devices. See replacement choices and partially synced data.

Last updated on