Obsidian LiveSync CLI

A headless, self-hosted client for the community-built Obsidian LiveSync plugin that keeps a local Obsidian vault continuously in sync with a CouchDB or…

  • Backup
  • Cloud
  • Tools & Utilities
A headless, self-hosted client for the community-built Obsidian LiveSync plugin that keeps a local Obsidian vault continuously in sync with a CouchDB or object-storage backend (MinIO, S3, R2) so every connected device shares the same notes, without ever running Obsidian itself. Built for homelab users who want dependable, fully self-hosted Obsidian syncing without a desktop computer left running.

Platform availability

Available on 2 of 10 platforms

  • Unraid
  • TrueNAS (not listed)
  • Umbrel (not listed)
  • ZimaOS (not listed)
  • Proxmox (not listed)
  • Helm (not listed)
  • Mac (not listed)
  • Windows (not listed)
  • Linux (not listed)
  • Any server

Health score?A 0-100 score computed nightly from four factors: maintained (40%: recent commits and steady activity), popular (25%: GitHub stars, log scale), easy to install (20%: platforms, install notes, setup guides, Docker image) and light to run (15%: minimum RAM, ARM support). When the source code has been checked, a fifth factor, security check (20%: automated scan for committed secrets, unsafe desktop-app settings, known-vulnerable dependencies and project hygiene; any serious finding caps it at 20), is added. Factors without data are left out and the rest are rescaled.

70/100 Good

Maintained
100last commit 8 days ago
Popular
8212,989 GitHub stars
Easy to install
452 install platforms, install notes, Docker image
Light to run
No data
Security check
201 serious finding, 1 minor, CI, tests

Based on 4 of 5 factors.

Availability: platform listings confirmed today, links checked 19 days ago

GitHub stars
12,989
Open issues
257
Last commit
2026-11-13
Latest release
1.0.50
License
MIT
Activity
rising

Checked 6 days ago - source: GitHub (vrtmrz/obsidian-livesync)

Resources & Compatibility

Requirements not published yet.

Checked 54 days ago - source: Docker Hub image tags and published docs

First-install notes

  • Register Lucide icons before building UI In Roblox Studio, put the Obsidian and Lucide modules in ReplicatedStorage (Roblox's shared game folder), require them, and call Library:SetIconModule(Icons) before adding any UI. Without this, the library cannot find the icon list, so icons may be missing or the UI setup can fail. source
  • Connect ThemeManager to the UI library After loading the ThemeManager addon, call ThemeManager:SetLibrary(Library) before making tabs. This step links the theming tool to the actual UI controls, so theme options can be applied to the user's screen. source
  • Synchronisation backend Set up a self-hosted LiveSync backend, such as CouchDB or object storage (MinIO, S3, R2); it is not compatible with official Obsidian Sync. source
  • Setup guides & prerequisites Full setup guides, troubleshooting and technical references live in the documentation index (docs/README.md) of the GitHub repo. The client needs a CouchDB instance or an S3-style object-storage bucket (MinIO, S3, R2); the optional peer-to-peer mode uses WebRTC but still requires a signalling relay for peer discovery. source

Fetched today - each note links to its source

Alternatives (12)

  • AFFiNE - AFFiNE is a privacy-focused, local-first, open-source workspace that merges docs, canvas, and tables into a single platform as an alternati…
  • Anchor - Anchor is an offline-first, self-hostable note-taking application for people who want private, local notes with rich editing, tags, attachm…
  • Anytype - Organizes notes, tasks, and projects offline using Markdown, P2P syncing, and encrypted storage, complemented by dynamic collections on all…
  • AppFlowy - AppFlowy is an open-source, AI-powered workspace for managing projects, wikis, and team collaboration.
  • Colanode - Colanode is an open-source, local-first self-hosted workspace for real-time chat, Notion-style documents, and customizable databases that h…
  • Google Keep - Multifunctional cross-device tool captures ideas, lists, voice/photo notes.
  • Ignis - Ignis is a compatibility shim that runs Obsidian as a self-hosted web app by providing browser-compatible Electron APIs, giving users a bro…
  • Joplin - Open source note-taking app with Markdown support, to-do integration, and synchronization with cloud services like Dropbox and OneDrive.
  • Logseq - Logseq is a privacy-first, open-source platform for knowledge management and collaboration.
  • Memos - A modern, open-source, self-hosted knowledge management and note-taking platform designed for privacy-conscious users and organizations.
  • Microsoft OneNote - Microsoft OneNote, part of the Microsoft 365 Copilot, is a digital notebook application that gives people one place to gather notes and inf…
  • Nexlore - Nexlore is a notes app for your own server, in the browser: Markdown files on your disk, written in a real editor (WYSIWYG, slash menu, tab…

Checked 41 days ago - source: AlternativeTo

Common questions

Can I use object storage instead of CouchDB for self-hosted LiveSync?

Yes. It can use CouchDB or object storage systems such as MinIO, S3, and R2.

What wizard option do I choose when connecting self-hosted LiveSync to a server?

In Obsidian LiveSync options, select the wizard pane and choose the discard-existing preferences option.

How easy is it to repair a broken multi-device self-hosted LiveSync setup?

A forum user reports that it can become hard to repair across devices. They also note limited documentation for updates or fixes.

What has a user reported about syncing between desktop and other devices?

One Reddit user says it has generally worked well despite some issues.

Answers sourced from forum.obsidian.md, github.com, www.reddit.com, www.reddit.com

Community

Collected 49 days ago - public community threads