First Sync

First sync is the one-time push of your vault to Engram. The plugin walks you through it the first time you open the settings page. There’s nothing to push manually.

Open the plugin settings

In Obsidian: Settings → Community plugins → Engram Vault Sync (click the gear icon). This is the plugin’s settings tab and where every sign-in / backend / sync option lives.

Choose cloud or self-host

At the top of the settings page, pick your backend:

• Cloud points at app.engram.page. The default. Use this if you signed up at app.engram.page.
• Self-Host points at your own backend URL (e.g. https://engram.yourdomain.com). Use this if you’re running the self-host stack.

The plugin remembers the choice per vault.

Sign in

Click Sign in in the settings page. The plugin starts a device flow: it shows a short user code and opens the backend’s verification page in your browser. Enter the code there and approve. The plugin polls in the background and confirms sign-in once you’ve approved. There’s no token handed back over a URL scheme.

Complete the first-sync modal

As soon as sign-in completes, the plugin shows the First Sync modal automatically. The modal walks you through the one-time vault snapshot push.

Caution

You must complete the First Sync modal. Until you select First Sync and let the snapshot finish, the plugin will not start syncing your vault. No pushes, no pulls. If you dismiss the modal, reopen it from the plugin’s settings page.

Snapshot speed depends on vault size: a few hundred notes finishes in seconds, tens of thousands of notes can take a few minutes. Don’t quit Obsidian during the initial push.

After the first sync

The plugin is now live. Edits in Obsidian propagate within a couple seconds. Edits from other devices (web app, another Obsidian install) appear in your vault automatically.

Open app.engram.page and your vault should be browsable in seconds.

Next: Sync Center.