WebDAV Sync

unlisted

by Hēsperus

General-purpose & bidirectional WebDAV syncing for your vault. Designed for stability and robust file handling without vendor lock-in.

25 starsUpdated todayAGPL-3.0
View on GitHub

Obsidian WebDAV Sync logo
Obsidian WebDAV Sync

General-purpose & bidirectional WebDAV syncing for your vault.

ci TypeScript

简体中文 License

Introduction

Obsidian WebDAV Sync is a general-purpose syncing plugin for Obsidian via a WebDAV server.

There's already a lot of plugins to sync your notes between devices. But when we have a look at the syncing plugin landscape, we can clearly see that each plugin has its own disadvantages that prevents you from using it:

  • Remotely Save: full-featured syncing plugin, but currently unmaintained and full of bugs (like deleted files come back).
  • Syncthing Integration: a great way of P2P syncing, but requires both of your devices to be online, not 24/7.
  • Live Sync: most robust solution in the room, but requires custom server setup.
  • Git Integration: ideal for production-level collaboration and provenance, but not suitable for daily usage.
  • Vendor-specific Syncing Plugin (like Nutstore Sync): tailored experiences, but locked to a single vendor.

Acknowledging that WebDAV would be the most convenient DIY solution for syncing, this plugin comes to provide a balanced experience of day-to-day convenience, easy setup, and the robustness that doesn't make your notes into a chaos.

Features

  • 🔄 Bidirectional syncing between local vault and remote WebDAV
  • Fast syncing mode with cached acceleration for fast, sync-on-change syncing
  • 📁 WebDAV explorer for exploring remote directories
  • 🔀 Conflict handling:
    • Smart merge
    • Latest survive
    • Use remote
    • Use local
    • Skip
  • 🚀 Strict / loose sync modes for different vault sizes
  • 📦 Large file skipping via configurable size threshold
  • 🔁 Robust file handling that doesn't mess up your notes
  • 📜 Lightweight local database empowers scalability and ensures performance

Install & Setup

This plugin is currently in beta. You can install it using the BRAT plugin:

  1. Go to Community plugins and search for BRAT
  2. Install and enable it
  3. Go to BRAT settings, click Add beta plugin, copy and paste https://github.com/hesprs/obsidian-webdav-sync into the Repository field
  4. Select the latest version and click Add plugin

Configuration:

  1. Enter WebDAV server URL
  2. Enter account + credential
  3. Click Check connection
  4. Select remote directory
  5. Start sync

Notes

  • Initial sync may take longer for large vaults
  • Backup important notes before first sync
  • The file presence resolution and note merging are robust, but not perfect

Development Roadmap

Below is a list of planned features and improvements, the faster this plugin is adopted and the star ⭐ grows, the faster the development will be. Also, we welcome contributors that would like to help us with the development.

  • Support syncing files in the Obsidian config folder (.obsidian/)
  • Saving WebDAV credentials in Obsidian Keychain
  • Allow users to adjust rate and concurrency limits
  • Enhance observability of sync progress

License and Copyright

Obsidian WebDAV Sync is forked from Obsidian Nutstore Sync and has undergone significant overhaul with focuses on no vendor lock-in, performance, and stability, licensed under the AGPL-3.0 License. This project is not affiliated with Nutstore.

Copyright ©️ 2026 Hesprs (Hēsperus) (modifications), 2025-2026 Nutstore (unchanged parts)

For plugin developers

Search results and similarity scores are powered by semantic analysis of your plugin's README. If your plugin isn't appearing for searches you'd expect, try updating your README to clearly describe your plugin's purpose, features, and use cases.