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>
56 lines
1.4 KiB
Markdown
56 lines
1.4 KiB
Markdown
---
|
|
title: Deployment Overview
|
|
summary: 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:
|
|
|
|
```sh
|
|
pnpm paperclipai onboard
|
|
```
|
|
|
|
Or update it later:
|
|
|
|
```sh
|
|
pnpm paperclipai configure --section server
|
|
```
|