vorotamorozSelf-hosted LiveSync
Self-hosted LiveSync is a community-developed synchronisation plug-in available on all Obsidian-compatible platforms. It leverages robust server solutions such as CouchDB or object storage systems (e.g., MinIO, S3, R2, etc.) to ensure reliable data synchronisation.
Additionally, it supports peer-to-peer synchronisation using WebRTC, enabling you to synchronise your notes directly between devices without relying on a server. Documentation is available for Peer-to-Peer Synchronisation.
Important
This plug-in is not compatible with the official "Obsidian Sync" and cannot synchronise with it.
Features
- Synchronise vaults efficiently with minimal traffic.
- Handle conflicting modifications effectively.
- Automatically merge simple conflicts.
- Use open-source solutions for the server.
- Compatible solutions are supported.
- Support end-to-end encryption.
- Synchronise settings, snippets, themes, and plug-ins via Customisation Sync (Beta) or Hidden File Sync.
- Enable WebRTC peer-to-peer synchronisation without requiring a
host(Experimental).- This feature is still in the experimental stage. Please exercise caution when using it.
- WebRTC is a peer-to-peer synchronisation method, so at least one device must be online to synchronise.
- Instead of keeping your device online as a stable peer, you can use two pseudo-peers:
- livesync-serverpeer: A pseudo-client running on the server for receiving and sending data between devices.
- webpeer: A pseudo-client for receiving and sending data between devices.
- A pre-built instance is available at fancy-syncing.vrtmrz.net/webpeer (hosted on the vrtmrz's blog site). This is also peer-to-peer. Feel free to use it.
- For more information, refer to the English explanatory article or the Japanese explanatory article.
This plug-in may be particularly useful for researchers, engineers, and developers who need to keep their notes fully self-hosted for security reasons. It is also suitable for anyone seeking the peace of mind that comes with knowing their notes remain entirely private.
Important
- Before installing or upgrading this plug-in, please back up your vault.
- Do not enable this plug-in alongside another synchronisation solution (including iCloud and Obsidian Sync).
- For backups, we also provide a plug-in called Differential ZIP Backup.
How to Use
3-minute setup - CouchDB on fly.io
Recommended for beginners
- Set up CouchDB on fly.io
- Configure plug-in in Quick Setup
Setup workflows
Choose a synchronisation method, prepare its server where required, then follow the corresponding client setup:
- CouchDB
- Prepare the server:
- Configure the clients by following CouchDB Quick Setup.
- Object Storage
- Prepare the server. A maintained MinIO server installation guide is not currently available here, so set up an S3-compatible service or server of your choice.
- Configure the clients by following Object Storage Setup.
- Peer-to-Peer
- No server setup is required.
- Configure the clients by following Peer-to-Peer Setup.
Each workflow establishes ordinary note synchronisation on the first device, generates the additional-device Setup URI from that working device, and verifies synchronisation in both directions.
Tip
Fly.io is no longer free. Fortunately, we can still use IBM Cloudant despite some limitations. Refer to Set up IBM Cloudant. We can also use peer-to-peer synchronisation without a server. Alternatively, cheap object storage like Cloudflare R2 can be used for free. However, most importantly, we can use a server that we trust. Therefore, please set up your own server. CouchDB can also be run on a Raspberry Pi (please be mindful of your server's security).
Information in the Status Bar
Synchronisation status is shown in the status bar with the following icons.
- Activity Indicator
- 📲 A finite remote operation is in progress
- 🌐N Approximate remote requests currently in progress
- Status
- ⏹️ Stopped
- 💤 LiveSync enabled. Waiting for changes
- ⚡️ Synchronisation in progress
- ⚠ An error occurred
- Statistical Indicators
- ↑ Uploaded chunks and metadata
- ↓ Downloaded chunks and metadata
- Progress Indicators
- 📥 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 for hidden files
- 🧩 Waiting chunks
- 🔌 Working customisation items (configuration, snippets, and plug-ins)
To prevent file and database corruption, please avoid closing Obsidian until all progress indicators have disappeared as much as possible (although the plug-in will attempt to resume if interrupted). This is especially important if you have deleted or renamed files.
Tips and Troubleshooting
- If you want a faster and simpler initial replication when setting up subsequent devices, see the Fast Setup Guide.
- Configure Hidden File Sync only after ordinary note synchronisation works.
- If you are having problems getting the plug-in working, see Tips and Troubleshooting.
Acknowledgements
The project has been in continual progress and harmony thanks to the following:
- 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.
Development Guide
Please refer to the Development Guide for development setup, testing infrastructure, code conventions, and more.
License
Licensed under the MIT License.