docs: enhance Obsidian connector installation instructions and add BRAT installation method

This commit is contained in:
Anish Sarkar 2026-04-22 17:34:27 +05:30
parent 3eb4d55ef5
commit 1d324f169f

View file

@ -25,13 +25,23 @@ This works for cloud and self-hosted deployments, including desktop and mobile c
## Quick start
1. Open **Connectors** in SurfSense and choose **Obsidian**.
2. Click **Open plugin releases** and install the latest SurfSense Obsidian plugin.
3. In Obsidian, open **Settings → SurfSense**.
2. Install the plugin (recommended via BRAT) using the steps below.
3. In Obsidian, open **Settings → SurfSense**.
4. Paste your SurfSense API token from the user settings section.
5. Paste your Server URL in the plugin setting: either your SurfSense main domain (if `/api/v1` rewrites are enabled) or your direct backend URL.
6. Choose the Search Space in the plugin, then the first sync should run automatically.
7. Confirm the connector appears as **Obsidian - <vault>** in SurfSense.
## Install via BRAT (recommended)
1. In Obsidian, open **Settings → Community plugins** and install **BRAT**.
2. Open BRAT settings and click **Add beta plugin** button.
3. Paste the repository: `https://github.com/modsetter/SurfSense/`.
4. Select the latest plugin version, then enable **SurfSense**.
5. Open **Settings → SurfSense** to finish setup.
If BRAT is unavailable in your environment, use **Open plugin releases** in SurfSense and install manually from GitHub release assets.
## Migrating from the legacy connector
If you previously used the legacy Obsidian connector architecture, migrate to the plugin flow: