Skip to content

Local vs hosted

Sutraya runs in two auth modes:

Mode Behavior
local (default for laptop/Docker) Single implicit Local Reader — no login UI
hosted Multi-user email/password via Better Auth

Personal data always scopes to a user id — in local mode that id is the Local Reader.

  1. Set AUTH_MODE=hosted and BETTER_AUTH_SECRET.
  2. Set SUTRAYA_ADMIN_EMAILS before first deploy so someone can open Settings.
  3. Optionally claim Local Reader content into a new signed-in account after flipping modes.
  4. Configure Usage (require login for AI, quotas) and Accounts as needed.

Readers: Account & signing in · Operators: Settings.