# Self-hosted LiveSync

> Sync Obsidian notes to every device from your own server.

- Page: https://cgt.octabyte.io/templates/obsidian-livesync/
- Category: Docs & wikis
- Replaces: Obsidian Sync
- Ease of use: Some setup. Install the free Self-hosted LiveSync plugin in Obsidian, enter your server's address, the sign-in Cloudgate shows you and a passphrase, then link your other devices.
- App price: Free. To run it you need Cloudgate (hosted, or free to install yourself) and a server, which hosted Cloudgate can provide.
- License: MIT
- Good for: Obsidian users who want their notes on every device without paying for Obsidian Sync
- Official website: https://github.com/vrtmrz/obsidian-livesync
- Documentation: https://github.com/vrtmrz/obsidian-livesync/blob/main/docs/setup_own_server.md
- Source code: https://github.com/vrtmrz/obsidian-livesync
- Last updated: 2026-11-20

## What is Self-hosted LiveSync?

Self-hosted LiveSync syncs your Obsidian notes across computers and phones through your own self-hosted server, encrypted, instead of paid Obsidian Sync.

Self-hosted LiveSync is a free, open-source Obsidian Sync alternative: a community plugin for Obsidian that keeps your notes the same on every computer and phone through a sync server you own. It is not made by Obsidian, and it replaces only the paid Sync add-on, so you keep writing in Obsidian exactly as you do now.

Edit a note on your laptop and it shows up on your phone within moments. Notes are encrypted on your device with a passphrase only you know before they reach the server, so the server holds nothing it can read. There is no limit on vaults, devices or storage beyond your server's disk. A consultant, for example, could write meeting notes on a work laptop, check them on a phone at a client's office and keep client details off anyone else's cloud.

The plugin works wherever Obsidian runs: Windows, Mac, Linux, iPhone, iPad and Android. It cannot sync with Obsidian Sync or iCloud, so turn those off for the vault and make a backup before you switch.

Cloudgate installs the sync server on a server Cloudgate provides or one you connect, and gives it the secure web address that phones need. Then install the plugin in Obsidian on each device and connect it with your server's address, sign-in and passphrase.

## What you can do with Self-hosted LiveSync

- **Keep every device up to date**: Notes you write on your laptop appear on your phone and other computers within moments, and only the changed parts are sent.
- **Encrypt notes before they leave**: Notes are locked with a passphrase on your device, so the server stores only data it cannot read, and file names can be hidden too.
- **Add a new device in a minute**: Copy a setup link or show a QR code on your first device, and the next one gets the same connection and encryption settings.
- **Sort out clashing edits**: When two devices change the same note, simple clashes merge on their own and the rest are kept for you to choose.
- **Go back to an earlier version**: Open a note's history and restore a version from before a change.
- **Bring your settings along**: Optionally sync your themes, snippets, plugins and Obsidian settings, not just your notes.

## Replaces Obsidian Sync

Self-hosted LiveSync does the same job as Obsidian Sync. Here is what changes when you switch.

### What you gain

- No monthly subscription, and no vault, storage or file-size limits beyond your server's disk
- Your notes stay on your own server, encrypted with a passphrase only you know
- Sync as many vaults and devices as you like
- You keep using Obsidian exactly as before, with all your plugins

### What is different

- It is a community plugin, so Obsidian's own support does not cover it
- Setting up each device takes a few more steps than signing in to Obsidian Sync
- It cannot sync with Obsidian Sync or iCloud, so turn those off for the vault first
- You look after the server and its backups yourself

## What happens when you click Deploy?

Deploy link: https://cloudgate.octabyte.app/get-started?template=obsidian-livesync

1. **Click Deploy and create your account.** Deploy takes you to Cloudgate. Create an account, or log in if you have one. Self-hosted LiveSync itself is free.
2. **Choose a server.** No server? Get one from Cloudgate: pick a size and a country, and Cloudgate gets it ready. Already have one? Connect it instead.
3. **Cloudgate sets up Self-hosted LiveSync.** It prepares the server, makes the passwords the app needs and starts it. There is nothing to install and nothing to write down.
4. **Open your app and sign in.** Your app gets a free web address to start, without https. Add your own domain, like app.yourshop.com, and Cloudgate secures it with https for you.

## Questions

### Is Self-hosted LiveSync free?

Yes, Self-hosted LiveSync is free and open source under the MIT licence, and it has no paid edition. Obsidian itself is free too, so you pay only for the server that keeps your notes.

### Is Self-hosted LiveSync a good alternative to Obsidian Sync?

Yes, Self-hosted LiveSync is a good Obsidian Sync alternative if you are happy to run your own server in exchange for no subscription and full control of your notes. Obsidian Sync is simpler to set up and supported by Obsidian, while Self-hosted LiveSync has no vault or storage limits and keeps your encrypted notes on your server.

### Is Self-hosted LiveSync made by Obsidian?

No, Self-hosted LiveSync is a community plugin written by an independent developer, vorotamoroz, not by the company behind Obsidian. It cannot sync with Obsidian Sync, so use one or the other for a vault, never both.

### How do I connect Obsidian to my server the first time?

You install Self-hosted LiveSync in Obsidian from the Community plugins list, open its setup and enter your server's web address, the user name you chose when installing, the password Cloudgate created for it (shown on the app's variables page), the database name obsidiannotes and an encryption passphrase of your own. Then copy a setup link from that first device to connect each other device. Back up your vault before you start.

### Does Self-hosted LiveSync work on iPhone and Android?

Yes, Self-hosted LiveSync works in the Obsidian app on iPhone, iPad and Android, as well as on Windows, Mac and Linux. Phones need a secure https address, which Cloudgate gives your server.

### Can the Self-hosted LiveSync server read my notes?

No. The Self-hosted LiveSync server cannot read your notes when you turn on end-to-end encryption, which the plugin strongly recommends. Notes are encrypted on your device with your passphrase before they are sent, so keep the passphrase safe, because without it the notes cannot be read.

### What server size do I need for Self-hosted LiveSync?

A very small server is enough to run Self-hosted LiveSync for one person's notes, because the server only stores and passes on the changes. Choose a larger disk if your vault holds many pictures or PDFs.

### Do I need technical skills to run Self-hosted LiveSync?

No. Click Deploy, create your Cloudgate account and choose a server, and Cloudgate sets up Self-hosted LiveSync and gives it a web address. You use it in your browser like any other online tool.

### Do I need my own server for Self-hosted LiveSync?

No. When you deploy Self-hosted LiveSync, hosted Cloudgate can provide a server. If you already rent one, you can connect it instead.

### Can I move my data from Obsidian Sync to Self-hosted LiveSync?

Most people export from Obsidian Sync and import into Self-hosted LiveSync. The official guides at github.com walk through it.
