Sync server
Private, self-hosted sync and live collaboration for Obsidian notes.
Accept the invitation in Obsidian
This link gives one person access to a set of notes on . Obsidian cannot receive the invitation directly, so it is copied for you to paste into the plugin’s Join dialog. Nothing is joined until you choose a folder there and confirm.
Then open Obsidian and paste it into Join a shared invitation.
This page is served over plain http. The plugin only connects to https:// servers (and localhost for development), so the invitation cannot be joined from this address.
What happens in Obsidian
- Obsidian opens the plugin’s Join a shared link dialog. The plugin must be installed and signed in to (Settings → Obsidian Collab); an invitation can only be accepted by a signed-in plugin.
- Paste the copied link into Share link. The part after
#is the invitation and must be included. - Choose an empty folder to receive the notes and press Join.
If Obsidian did not open, install Obsidian and the Obsidian Collab plugin (repository), then run the command Join a shared invitation yourself. Each invitation works once and only for the notes it was created for. Notes cannot be viewed or edited in a browser.
This invitation link is incomplete
The address after # does not look like an invitation this server can accept. Links are easy to truncate when copied from chat or email.
- Ask the sender to copy the link again from Obsidian (Sharing → Shared by you) and send it in full. A valid link ends in
#collab=followed by 64 letters and digits. - If you were sent the link in pieces, join them into a single line with no spaces before opening it.
- Invitations that were revoked or already used cannot be repaired here; the sender can issue a new one.
No part of the link was sent to this server or anywhere else while loading this page.
Connect Obsidian to this server
This server stores notes and relays changes between devices. It has no web editor: notes live in Obsidian, which needs the Obsidian Collab plugin and an account on this server.
- Install Obsidian (desktop, iOS, or Android).
- Install the Obsidian Collab plugin from github.com/theolundqvist/obsidian-collab and enable it in Settings → Community plugins.
- Open Settings → Obsidian Collab, enter as the server, and create an account or sign in.
- Choose which folders to sync. Everything stays private to your account until you share a note, folder, or vault from its context menu.
This page is served over plain http. The plugin only connects to https:// servers (and localhost for development); put this server behind TLS before using it from other devices.
What to know before you connect
- Synced notes and attachments are readable by the server operator; they are not end-to-end encrypted. Remote servers require HTTPS. Local development HTTP connections are not encrypted.
- Sync only happens through the plugin. Without it, nothing on this server is reachable from your vault.
- On iPhone, iPad, and Android, syncing runs only while Obsidian is open and in the foreground. Your phone catches up the next time you open the app.
- Your Obsidian configuration folder and plugin files are excluded from vault sync. Selected notes and attachments are uploaded as they are.