Self-Hosted LiveSync

Japanese docs - Chinese docs.

Self-Hosted LiveSync is a community-implemented synchronization plugin, available on every Obsidian-compatible platform and using CouchDB or Object Storage (e.g., MinIO, S3, R2, etc.) as the server.

Note: This plugin cannot synchronise with the official "Obsidian Sync".

Features

• Synchronize vaults very efficiently with less traffic.
• Good at resolving merge conflicts.
  • Automatic merging for simple conflicts.
• Using OSS solution for the server.
  • Compatible solutions can be used.
• Supports end-to-end encryption.
• Synchronisation of settings, snippets, themes, and plugins, via Customization Sync (Beta) or Hidden File Sync
• WebClip from obsidian-livesync-webclip

This plugin might be useful for researchers, engineers, and developers with a need to keep their notes fully self-hosted for security reasons. Or just anyone who would like the peace of mind of knowing that their notes are fully private.

Important

• Before installing or upgrading this plugin, please back your vault up.
• Do not enable this plugin with another synchronization solution at the same time (including iCloud and Obsidian Sync).
• This is a synchronization plugin. Not a backup solution. Do not rely on this for backup.

How to use

3-minute setup - CouchDB on fly.io

Recommended for beginners

1. Setup CouchDB on fly.io
2. Configure the plugin using Quick Setup

Manual Setup

1. Setup the server
   1. Setup CouchDB on fly.io
   2. Setup your CouchDB
2. Configure the plugin using Quick Setup

Tip

Now, fly.io has become not free. Fortunately, even though there are some issues, we are still able to use IBM Cloudant. Here is Setup IBM Cloudant. It will be updated soon!

Statusbar Icons

Synchronization status is shown in the status bar with the following icons.

• Activity Indicator
  • 📲 Network request
• Status
  • ⏹️ Stopped
  • 💤 LiveSync enabled. Waiting for changes
  • ⚡️ Synchronization in progress
  • ⚠ An error occurred
• Statistical indicator
  • ↑ Uploaded chunks and metadata
  • ↓ Downloaded chunks and metadata
• Progress indicator
  • 📥 Unprocessed transferred items
  • 📄 Working database operation
  • 💾 Working write storage processes
  • ⏳ Working read storage processes
  • 🛫 Pending read storage processes
  • 📬 Batched read storage processes
  • ⚙️ Working or pending storage processes of hidden files
  • 🧩 Waiting chunks
  • 🔌 Working Customisation items (Configuration, snippets, and plug-ins)

To prevent file and database corruption, please try to wait until all progress indicators have disappeared before closing Obsidian (especially if you have deleted or renamed files). The plugin will also try to resume, though.

Tips and Troubleshooting

If you are having problems getting the plugin working, see: Tips and Troubleshooting

Acknowledgements

The project has been in continual progress and harmony because of

• Many Contributors
• Many GitHub Sponsors
• JetBrains Community Programs / Support for Open-Source Projects

May those who have contributed be honoured and remembered for their kindness and generosity.

License

Licensed under the MIT License.