09d2ef1a37
- Restored docs/ directory that was accidentally deleted by `git add -A` in the v0.2.3 release script - Replaced generic "P" favicon with actual paperclip icon using brand primary color (#2563EB) - Added light/dark logo SVGs for Mintlify navbar (paperclip icon + wordmark) - Updated docs.json with logo configuration for dark/light mode - Fixed release.sh to stage only release-related files instead of `git add -A` to prevent sweeping unrelated changes into release commits Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
1.4 KiB
1.4 KiB
title, summary
| title | summary |
|---|---|
| Deployment Overview | Deployment modes at a glance |
Paperclip supports three deployment configurations, from zero-friction local to internet-facing production.
Deployment Modes
| Mode | Auth | Best For |
|---|---|---|
local_trusted |
No login required | Single-operator local machine |
authenticated + private |
Login required | Private network (Tailscale, VPN, LAN) |
authenticated + public |
Login required | Internet-facing cloud deployment |
Quick Comparison
Local Trusted (Default)
- Loopback-only host binding (localhost)
- No human login flow
- Fastest local startup
- Best for: solo development and experimentation
Authenticated + Private
- Login required via Better Auth
- Binds to all interfaces for network access
- Auto base URL mode (lower friction)
- Best for: team access over Tailscale or local network
Authenticated + Public
- Login required
- Explicit public URL required
- Stricter security checks
- Best for: cloud hosting, internet-facing deployment
Choosing a Mode
- Just trying Paperclip? Use
local_trusted(the default) - Sharing with a team on private network? Use
authenticated+private - Deploying to the cloud? Use
authenticated+public
Set the mode during onboarding:
pnpm paperclipai onboard
Or update it later:
pnpm paperclipai configure --section server