Rock Sync

by Tim Kovalev
5
4
3
2
1
Score: 50/100

Description

Self-hosted sync solution for obsidian vaults.

Reviews

No reviews yet.

Stats

1
stars
62
downloads
0
forks
13
days
3
days
4
days
9
total PRs
0
open PRs
3
closed PRs
6
merged PRs
0
total issues
0
open issues
0
closed issues
30
commits

Latest Version

5 days ago

Changelog

What's Changed

  • improve connection status and added Sync now buttonsync/pull/7
  • add a new admin page to view vault changes history

Full Changelog: https://github.com/kovalevtech/obsidian-rock-sync/compare/1.2.0...1.3.0

README file from

Github

Rock Sync

Self-hosted, single-user sync for Obsidian: a plugin on every device and one server that keeps your vaults in git.

  • Every file type, every version. Each change is a commit, so nothing you synced is lost.
  • Real merges. The server merges edits to the same note, and you only resolve what truly conflicts, in a view of its own.
  • Nothing is deleted behind your back. A deletion from another device waits for your confirmation.
  • Several vaults, a token per device and vault, connected with a one-time code, revocable at any time.
  • Claude can read and write the folders you choose, through MCP, if you turn it on.
 Obsidian + plugin ──┐
 Obsidian + plugin ──┼── sync API ──┐
 Obsidian + plugin ──┘              ├── server ── vaults (files + git history)
                                    │          └─ database (vaults, tokens)
 Claude (MCP connector) ── /mcp ────┘
 You (browser) ─────────── /admin ──┘

Quick start

1. The server. Save this as compose.yml:

services:
  rock-sync:
    image: ghcr.io/kovalevtech/obsidian-rock-sync:latest  # better: a version
    environment:
      INIT_VAULT_NAME: notes
      INIT_VAULT_CODE: ${INIT_VAULT_CODE:?pick 6 digits and put them in .env}
    volumes:
      - vaults:/vaults
      - db:/db
    ports:
      - 127.0.0.1:9292:9292
    read_only: true                       # it writes only to the two volumes
    cap_drop: [ALL]
    security_opt: [no-new-privileges:true]
volumes:
  vaults:
  db:
echo "INIT_VAULT_CODE=$(LC_ALL=C tr -dc 0-9 < /dev/urandom | head -c 6)" > .env
docker compose up -d

This creates the vault notes and a connection code for its first device. The server now answers on this machine only; to reach it from your other devices, see Deployment. It serves the sync API alone: the admin panel and MCP are opt-in through ENABLED_APPS, the admin panel best in a container of its own (Processes).

2. The plugin. Install Rock Sync from Community plugins and enable it (not listed yet?).

3. Connect. In the plugin's settings, enter the server's URL and the code from .env, Connect, check the summary and Save. The code works for that first device only; for the next ones, use the admin panel.

Network use

The plugin needs a Rock Sync server, which you run yourself. It sends your vault's files to that server, and only that server, because that's how they reach your other devices. There's no account, no telemetry and, by default, no third-party service.

If you turn on MCP on your server, Claude (Anthropic) can read and write the folders you grant there; the plugin itself is not involved.

Documentation

Page What it covers
Deployment How it makes sense to run it: network, proxy, storage, backups, updates
Exposing the server Behind a public proxy: what to allow, a Cloudflare example, checks from outside
Container The Docker image: every setting, volumes, users, why it won't start
Plugin Using the plugin: conflicts, deletions, first sync, limits
Admin panel Managing vaults and tokens in the browser
MCP Giving Claude access to chosen folders
Security Tokens, what's stored where, what isn't protected
Storage How vaults and history are kept on disk
API The sync API, for writing another client
Development Running from source, tests, releases
Releases What changed, and what to do when updating

License

PolyForm Noncommercial 1.0.0: free for personal and other noncommercial use. Any commercial use, including use inside a company, requires a separate license: .

Contributing

Issues are welcome. Pull requests are not accepted.