Deployment Modes
Paperclip has two runtime modes and one exposure choice. The mode determines how the board operator authenticates; the exposure choice determines whether the instance stays private or is reachable pu…
Deployment Modes
Paperclip has two runtime modes and one exposure choice. The mode determines how the board operator authenticates; the exposure choice determines whether the instance stays private or is reachable publicly.
Use this page when you are deciding how to run the instance, migrating an existing install, or checking what paperclipai doctor expects.
---
Mode Summary
| Mode | Exposure | Authentication | Typical use | |---|---|---|---| | localtrusted | Local only | No login required | Personal installs, development, demos | | authenticated + private | Private network | Login required | Tailscale, VPN, LAN | | authenticated + public | Internet-facing | Login required | Hosted production |
> Note: localtrusted is the default. If you never change anything, Paperclip behaves like a trusted local operator tool.
---
localtrusted
This is the simplest operating mode.