YAOS

YAOS pairs an Obsidian community plugin with a small sync server on Cloudflare Workers and Durable Objects. Edits from every device merge into one live vault state, so they do not turn into conflicted copies. An optional R2 bucket adds attachment sync and snapshots.

The README positions YAOS as a self-deployed alternative to Obsidian Sync, iCloud or Dropbox, and git-based sync plugins. The plugin keeps the CRDT state aligned with the files on disk, so changes that git, shell scripts or AI agents write into the vault propagate to other devices too. Text sync needs no terminal, .env file or database setup. Claiming the server in the browser locks it to one owner and generates the setup token the plugin uses. The button also creates a detached deployment repository, and updates are applied to it as commits through an updater workflow that the plugin settings can set up and run. On Cloudflare the server is a Worker with two SQLite-backed Durable Objects, one holding the CRDT state for each vault and one storing the claim and settings. Adding an R2 bucket turns on sync for images, PDFs and other attachments, daily snapshots, on-demand point-in-time backups, snapshot diffs and selective file restore.

Built for: Obsidian users who want real-time sync across their devices on their own Cloudflare account, set up without a terminal.

What you can use it for

• Sync a vault between desktop and phone on your own Cloudflare account
• Edit the same note on two devices at once and keep both changes
• Take daily snapshots and point-in-time backups of a vault in R2
• Restore single files from a snapshot after a bad edit
• Keep a vault in sync while scripts or AI agents write to it

Deploy

• One-click · main path

  Branch main

  Deploy to Cloudflare

• CLI

  cd server
  npm install
  npm run deploy

  Copy

Deploy with the button, open the Worker URL and click Claim. Then install the YAOS plugin from the Obsidian marketplace and open the setup link or scan the QR code.

What it needs to run

• Durable ObjectsServerConfig, VaultSyncServer
• R2 bucketsyaos

Good to know

Sync works only through the YAOS Obsidian plugin. A sync receipt confirms that the server saved a device's latest state, not that other devices received it. Empty folders and the .obsidian folder with settings and plugins do not sync. Attachments over 10 MB are skipped by default.

Cost on Cloudflare

Where this comes from

• Repositoryhttps://github.com/kavinsood/yaos
• App websitehttps://yaos.dev
• Documentationhttps://github.com/kavinsood/yaos/blob/main/docs/operations.md

An alternative to Obsidian Sync.