VaultConnect
pendingby jesus13g
Sync your vault with a backend and Google Drive, browse vaults visually, and push or pull incremental changes.
VaultConnect
Sync your Obsidian vault with a self-hosted backend and Google Drive. Browse your remote vaults visually, push local changes incrementally, and pull remote updates directly into Obsidian.
What it does
- Authenticates with a backend (email/password or Google OAuth).
- Lists vaults stored in the backend and lets you pick one to link with your local vault.
- Push: detects changed local files since the last sync and uploads only the diff.
- Pull: downloads files that changed on the server since the last pull.
- Optional Google Drive integration: each vault can be backed by a Drive folder that stays in sync automatically.
Requirements
- An account on the VaultConnect backend (self-hosted on Railway or another provider).
- Google Drive connection is optional but recommended for off-site backup.
Installation
- Open Obsidian → Settings → Community plugins → Browse.
- Search for VaultConnect and click Install, then Enable.
Alternatively, install manually by copying main.js and manifest.json into .obsidian/plugins/vault-connect/ inside your vault.
Configuration
- Open Settings → VaultConnect.
- Enter your Email and Password, then click Login email — or click Login with Google to authenticate via Google OAuth.
- Once logged in, click Select vault to pick an existing remote vault, or Create from this vault to create a new one from your current vault.
- Optionally click Connect Google Drive to link a Drive folder to the selected vault.
Usage
Use the sidebar panel (cloud icon in the left ribbon) or the toolbar buttons:
| Button | Action |
|---|---|
| Push | Upload local changes to the backend |
| Pull | Download remote changes to your vault |
| New | Create a new remote vault from the current local vault |
| Web | Open the backend web panel in your browser |
You can also run any of these via the Command Palette (Ctrl/Cmd+P → search "VaultConnect").
Privacy
The plugin sends your vault files (content + metadata) to the backend URL configured at build time. No data is sent to third-party services unless you connect Google Drive, in which case Google's OAuth flow is used and files are stored in your own Drive account. Credentials are stored locally in Obsidian's plugin data file.
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.