Docs

Environment Variables

Environment Variables This page lists the environment variables Paperclip reads for server configuration and the variables it injects into agent processes at runtime. Use it when you are wiring a dep…

Environment Variables

This page lists the environment variables Paperclip reads for server configuration and the variables it injects into agent processes at runtime.

Use it when you are wiring a deployment, debugging a startup issue, or checking what an adapter can see inside its process environment.

---

Server Configuration

| Variable | Default | Meaning | |---|---|---| | PORT | 3100 | Server port | | HOST | 127.0.0.1 | Server host binding | | DATABASEURL | embedded PostgreSQL | PostgreSQL connection string | | PAPERCLIPHOME | ~/.paperclip | Base directory for all Paperclip data | | PAPERCLIPINSTANCEID | default | Instance identifier for multiple local instances | | PAPERCLIPDEPLOYMENTMODE | localtrusted | Runtime mode override |

> Note: DATABASEURL is the main switch between the embedded database and external PostgreSQL.

---

Deployment And Auth

These variables matter most once you move beyond a default local install.