by thiago
Sync your vaults across devices using Git. Conflicts are resolved automatically using CRDTs, so you can work offline and sync when you reconnect.
Gitbin
Sync your Obsidian vaults across devices using Git. Work offline and sync when you reconnect, with concurrent text edits merged automatically.
- Install and enable Gitbin from Obsidian's community plugins.
- Open Settings → Gitbin, enter your repository's HTTPS URL and credentials with read/write access, then click Connect.
- Repeat on your other devices using the same repository and vault name, or use Scan to sync to set up your phone.
Feature highlights
- Work across devices. Sync notes and attachments automatically while Obsidian is open, or sync manually when you choose.
- Keep your repository. Store multiple vaults in one Git repository, each in its own folder.
- Review changes. Browse sync history and compare local, remote, and merged files.
- Set up another device. Reuse your repository and vault name, or use Scan to sync to transfer your setup to a phone.
- Save space. Download files when you open them and choose how much local storage to use.
- Maintain your vault. Consolidate old history or repair damaged metadata when needed.
Mobile support is experimental and has not yet been tested on physical devices.
How it works
Gitbin stores readable vault files in your Git repository alongside the metadata needed to merge changes. CRDTs combine concurrent text edits; attachments resolve as complete versions. Each device keeps pending changes locally until it can sync again.
Gitbin connects to the Git host you configure. Credentials stay in Obsidian's secret storage, and hidden configuration folders stay local. With on-demand downloads enabled, files remain visible in the explorer, but their contents must be downloaded before search, backlinks, or other plugins can read them.
[!WARNING] Avoid symbolic links and junctions in your vault. Gitbin uses Obsidian's file APIs, which don't expose local symlink detection. Linked files or folders may cause sync to read or modify files outside your vault. See Obsidian's guidance on symbolic links and junctions and Snyk's explanation of symlink risks for more information.
See also
For plugin developers
Search results and similarity scores are powered by semantic analysis of your plugin's README. If your plugin isn't appearing for searches you'd expect, try updating your README to clearly describe your plugin's purpose, features, and use cases.