Skip to content
Engram Docs

Troubleshooting

Symptoms → likely causes → things to try.

Sign-in fails

Section titled “Sign-in fails”

Sign-in uses a device flow: the plugin shows a short user code, opens the backend’s verification page in your browser, and polls until you approve. No token is handed back through the obsidian:// URL scheme.

  • The verification page never opens. Copy the user code shown in the sign-in dialog and open the verification URL manually, then paste the code. Check that your Engram URL (Cloud vs Self-Host) is correct in the plugin settings.
  • Approved in the browser but the plugin never confirms. The plugin polls for the token after you approve; give it a few seconds. If it still doesn’t confirm, close the dialog and start sign-in again from the plugin’s settings page.
  • “Invalid token” after sign-in. Your session may have expired. Sign out from the plugin’s settings page and sign in again.

Sync is stuck “Pending push: N”

Section titled “Sync is stuck “Pending push: N””
  • Check the Sync Center → Recent activity log for the most recent error.
  • If the backend is reachable but pushes 409 (version conflict), it’s likely a real conflict; open the Conflicts queue.
  • If pushes return 413, the note is over the per-note size cap. Split it.
  • If pushes return 429, you’re being rate-limited. Wait a minute and retry, or check your subscription tier.

Web app shows stale content

Section titled “Web app shows stale content”
  • Pull the page once (refresh). The web app subscribes to live updates but the initial load is cached.
  • Confirm the plugin in Obsidian shows Last sync time later than your most recent edit.

A specific note won’t sync

Section titled “A specific note won’t sync”
  • Check the path for illegal characters (especially on mobile, see Mobile).
  • Check note size. There is a per-note size cap.
  • Open the Sync Center, find the note in Pending push, hover for the error reason.

Plugin won’t load after update

Section titled “Plugin won’t load after update”
  • Open Obsidian’s developer console (Ctrl/Cmd+Shift+I) and check for errors mentioning engram-vault-sync.
  • Try toggling the plugin off and on in Settings → Community plugins.
  • If a release shipped broken, file the bug at engram-app/Engram-obsidian and uninstall the plugin temporarily. The previous version is not recoverable from inside Obsidian once the community-directory update installs.

Where to file bugs

Section titled “Where to file bugs”

engram-app/Engram-obsidian issues. Include:

  • Obsidian version, platform (desktop/iOS/Android), and OS version
  • Engram plugin version
  • Screenshot of the Sync Center → Recent activity log
  • Steps to reproduce