Paperclip runs in a layered ops model:

​
Ops Set

Use these docs together:
ConcernCanonical doc
Local devlocal-development.md
Deployment modesdeployment-modes.md
Docker and composedocker.md
Environment variablesenvironment-variables.md
Secretssecrets.md
Databasedatabase.md
Storagestorage.md
Runtime servicesruntime-services.md
Hosted ingressobs-hosted-ingress.md
Recovery../RECOVERY.md

​
Operator Defaults

  • Use pnpm dev for the fastest local loop.
  • Use local_trusted when you want zero-login local access on loopback.
  • Use authenticated + private for Tailscale, VPN, or LAN access.
  • Use authenticated + public only when the host is intentionally internet-facing.
  • Use ./scripts/intelligence-stack.sh for the additive hosted-monitor stack.
  • Treat obs-proxy as the single browser-facing ingress point for the hosted monitor.
  • Keep board/auth secrets separate from provider-connected-account auth and from application secrets.

​
First Commands

pnpm dev
pnpm paperclipai doctor
pnpm paperclipai configure --section server
./scripts/intelligence-stack.sh up

​
Recovery Entry Points