Where Does vdirsyncer Store Config and Status?
vdirsyncer keeps CalDAV and CardDAV account pairings in a config file plus a status folder, both under your home directory.
Last updated
vdirsyncer stores account config in a single config file (config.py in the XDG config home) and per-pair sync state in a status directory beside it. Calendars and contacts themselves live on the servers and in local maildir-style folders you choose.
That split keeps repairs simple. Config problems mean editing the file. Phantom conflicts mean wiping status and resyncing. Never hand-edit synced event files while a sync runs.
Where vdirsyncer stores this, by platform
~/.config/vdirsyncer/config.py
Account pairings and storage definitions in Python syntax. Status directory sits alongside; wipe it (idle only) to force a clean resync.
~/.config/vdirsyncer/config.py
Same file names and semantics as Linux. Homebrew installs read identical paths, so formulae changes keep your pairings.
Frequently asked questions
How do I migrate vdirsyncer to a new computer?
Copy the config file and the status directory to the same spots on the new machine, then run a discover and sync. OAuth tokens may need re-authorization per remote.
How do I reset vdirsyncer sync state?
Delete the contents of the status directory while nothing syncs. The next sync treats every item as new and re-downloads both sides cleanly.
Notice an outdated path? Let us know.