Skip to main content

​
Storage backends for uploaded files

Entries are text, stored in a git repository at the workspace root. Uploaded files (images, PDFs, media) are not in git — they live in one of two backends:
  • Local (default) — files are stored in .studiograph/assets/ on the server volume and streamed from disk. Zero configuration.
  • Cloudflare R2 — files are stored in an R2 bucket and served via signed URLs. Configure it with studiograph r2 setup, or in the web app under Settings → Providers → Asset Storage. Bucket metadata (account, bucket, public URL) lives in the committed workspace config; the credentials live in the encrypted secrets store.

​
What to back up

Safe to lose (rebuilt automatically): the search index, collaboration state (yjs-state/), and caches.

​
One-command backup

This produces a passphrase-protected .sgbackup bundle. Restore with:
If you back up the server volume yourself (volume snapshots, rsync), make sure the three databases above are included — the git repository alone is not a complete backup.

​
Health checks

  • GET /api/health — overall server health, including renderer status.
  • GET /api/health/dirty — reports uncommitted workspace state.