mrkeyoor.com_
Mon 07 Sept 17:59 UTC
Self-Hostedevaluationupdated 07 Sept 2026

obsidian-livesync review

Self-hosted LiveSync is an Obsidian plug-in that synchronises notes through your own CouchDB or S3-compatible storage, or directly between devices over WebRTC. It solves the private multi-device sync problem without requiring an Obsidian Sync subscription, while leaving server choice, backups, and recovery in your hands.

trackingstars / 7d
Verdict

Our Self-hosted LiveSync run installed 769 packages in 13 seconds and built cleanly in 18 seconds, but the repository exposed no tests target for us to run. Use it when private Obsidian sync is important enough to justify server care, staged device setup, and separate backups. Choose a narrower storage plug-in or general file synchroniser if CouchDB replication, WebRTC, and LiveSync's recovery model are more machinery than your vault needs.

We ran it

Lab card: what happened when we ran obsidian-livesyncScreenshot of obsidian-livesync (github.com/vrtmrz/obsidian-livesync)
Install✓ · 13s769 packages · 388 MB
Build✓ · 18s
Testsn/ano test script
Known vulns00 critical · 0 high · 0 moderate · 0 low (npm audit)
Repo930 files~118,492 lines of source · 13 MB · 9 CI workflows · tests dir

Answers from our run

Does obsidian-livesync build from source?

Dependencies installed in 13 seconds (769 packages), and the build succeeded in 18 seconds. We cloned commit 35a8a4b into a clean Debian container with 3 CPUs and no project-specific setup.

Does obsidian-livesync have tests you can run?

Not through a standard command: the project exposes no test script or target that our harness could run.

Does obsidian-livesync have known vulnerabilities in its dependencies?

npm audit found none in the dependency tree at the time of our run.

Who should not use obsidian-livesync?

Anyone who must mix this plug-in with Obsidian Sync, iCloud, or another vault sync tool: the README says not to run them together and states that Obsidian Sync is incompatible.

What are the alternatives to obsidian-livesync?

Remotely Save, Obsidian Git, Syncthing. Our Self-hosted LiveSync run installed 769 packages in 13 seconds and built cleanly in 18 seconds, but the repository exposed no tests target for us to run.

Setup3/5Quick plug-in install, but every sync mode needs careful setup
Docs5/5Detailed guides cover setup, overwrite choices, and recovery
Community5/512,262 stars, same-day updates, and active issue replies
Maturity4/5Version 1.0.27 is active; the issue queue remains large

Who it’s for

Obsidian users who want their vault stored on infrastructure they control.
Households and small teams that can operate CouchDB or an S3-compatible bucket.
Technical users who prefer peer-to-peer transfer and can keep both devices online during sync.
People willing to test restores and treat synchronisation as separate from backup.

Who it’s NOT for

Anyone who must mix this plug-in with Obsidian Sync, iCloud, or another vault sync tool: the README says not to run them together and states that Obsidian Sync is incompatible.
Users who want peer-to-peer sync while only one device is ever online: the README requires another device holding the data to be available, plus a signalling relay for discovery.
People seeking a maintenance-free service: CouchDB and object storage need credentials, security, monitoring, and an independent backup plan.
Teams that cannot tolerate careful first-device setup: the guides include explicit choices that overwrite the remote or replace local files.

Setup reality

Our sandbox installed 769 npm packages in 13 seconds and used 388 MB. The build succeeded in 18 seconds. There was no tests script or target, so tests were skipped; npm audit reported 0 known vulnerabilities. The checkout contained 930 files, about 118,492 source lines, and 9 CI workflows.

CouchDB needs a reachable HTTPS URL, database, username, and password. Object storage needs an endpoint, bucket, region, access key, secret key, and prefix. Setup URIs contain encrypted credentials and need a separate passphrase; vault encryption has its own passphrase.

Self-hosted LiveSync 1.0 requires Obsidian 1.7.2 or later. P2P still uses a signalling relay, may need TURN on restrictive networks, and requires both peers online for transfer. The README also warns against closing Obsidian while progress indicators remain, especially after renames or deletions.

Version 1.0.27 supports three different sync models

Self-hosted LiveSync 1.0.27 can move an Obsidian vault through CouchDB, S3-compatible object storage, or WebRTC peer-to-peer connections. CouchDB keeps a central database and supports continuous replication. Object storage uses buckets such as Cloudflare R2 or another S3-compatible service. P2P avoids a central copy of the vault, although a signalling relay still introduces a discovery service. The choice changes where data rests, which credentials exist, and when another device must be awake.

All 3 paths demand more care than signing into a hosted sync account. The README tells users to back up every vault, disable Obsidian Sync and iCloud for the same files, and verify ordinary notes before enabling hidden-file or customisation sync. That sequence matters. A setup screen can initialise a new remote, overwrite an existing one, fetch remote data over local files, or keep extra local files. Read those choices as data operations, not onboarding decoration.

The 769-package checkout builds cleanly but exposes no test target

Our fresh Debian sandbox installed 769 npm packages in 13 seconds, occupying 388 MB. The build completed in another 18 seconds on 3 CPUs with 8 GB of RAM. Those numbers make contributor setup reasonable for a TypeScript project of this size. The checkout itself had 930 files, about 118,492 lines of source, and 13 MB before dependencies, so a small Obsidian plug-in download sits on top of a substantial development codebase.

The repository has 9 CI workflow files and a tests directory, yet its package scripts did not provide a tests target that our runner could invoke. We therefore skipped tests rather than treating the directory as proof of a passing suite. Npm audit found 0 known vulnerabilities in the installed tree. That is useful evidence for commit 35a8a4b, but it does not test conflict resolution, remote upgrades, or recovery with a real multi-device vault.

What happened when we ran it

Our run installed 769 packages in 13 seconds and built the checked-out commit in 18 seconds without an error. The dependency tree used 388 MB on disk. No test command was available, so the test step was skipped. The clean build says the source could be bundled in our stated Node 22 container; it says nothing about whether two devices will reconcile a difficult rename or survive a remote outage.

The sandbox used no secrets and did not connect to CouchDB, an object store, or the public P2P relay. It also did not exercise Obsidian itself. The 0-vulnerability audit result covers known advisories in the installed npm tree on September 7, 2026. Anyone adopting the plug-in should still trial the exact back end, device mix, vault size, and recovery steps they expect to use, because those parts sit outside a repository build.

CouchDB setup needs four connection values and two passphrases

The manual CouchDB guide asks for a complete URL, username, password, and database name. Mobile clients require HTTPS. A Setup URI packages encrypted connection settings, including credentials, and its passphrase is separate from the vault encryption passphrase. Sending the URI and its passphrase over different channels is sensible, but the better lesson is operational: whoever administers LiveSync is now responsible for database access, certificate renewal, credential rotation, and backup restoration.

Object storage substitutes an endpoint, bucket, region, access key, secret key, and optional prefix. The guide recommends a distinct prefix per sync set and says object storage is not a vault backup. On the first device, the safe procedure is to create 1 ordinary test note, let it upload, then check a second device in both directions before turning on optional file handling. That is slower than a login, and much safer than guessing which copy is authoritative.

P2P removes the central copy but still needs two online devices

In version 1.0.27, P2P transfers vault data through an encrypted WebRTC connection while using a Nostr-compatible relay for peer discovery. The project's public relay saves you from provisioning that part, or you can supply another relay. A remote peer must explicitly approve the connection. If direct WebRTC cannot cross the networks involved, the troubleshooting guide discusses TURN, which adds another service and another place to secure credentials.

P2P has a practical availability limit that cloud-backed sync does not: at least 1 device containing the needed data must be online while another receives it. That can work well between a laptop and phone used at the same time. It is a poor match for devices that rarely overlap or for an unattended machine expected to fetch changes overnight. LiveSync does not make peer availability disappear merely because no central vault copy exists.

September 7 brought 12,262 stars, a release, and active reports

GitHub showed 12,262 stars, 449 forks, and 353 open issues and pull requests on September 7, 2026. A search limited to open issues returned 337 reports, so the queue is busy even after separating pull requests. The last push and release 1.0.27 both landed that day. Its release note fixes first-time object-storage setup when a custom HTTP handler is used against an empty remote, including a new Cloudflare R2 bucket.

Recent issue handling gives that large queue useful context. The maintainer said version 1.0.26 fixed an E2EE rebuild problem and object-storage startup sync; reporters were asked to retest, and the startup-sync reporter confirmed the correction. Another reporter confirmed that 1.0.26 stopped a case-only external folder rename from producing a deletion tombstone. Fast fixes are a good sign, but users should still read current release notes and test upgrades against a copied vault.

Alternatives

ProjectWhat it isPick it when
Remotely SaveAn Obsidian plug-in that syncs through S3, WebDAV, and several hosted drives.pick this instead when broad storage-provider support matters more than CouchDB replication or WebRTC.
Obsidian GitAn Obsidian plug-in that commits and synchronises a vault through Git.pick this instead when readable history and Git workflows matter more than live multi-device replication.
Syncthing gh↗A general file synchroniser that keeps folders aligned across your own devices.pick this instead when whole-folder replication is enough and you do not need Obsidian-aware conflict handling.

What people are saying

  1. [github-trending] vrtmrz/obsidian-livesync

Sources

  1. Self-hosted LiveSync README
  2. CouchDB quick setup guide
  3. Object Storage setup guide
  4. Peer-to-peer setup guide
  5. Self-hosted LiveSync 1.0.27 release
  6. Case-only folder rename report and fix confirmation

More self-hosted reviews

koodo-reader · LunaTV · warmbly · valkey · codex2api · hydra · the whole board →