How do I deploy Paperclip on Railway?

You can deploy Paperclip on Railway by clicking the "Deploy Now" button on this page. Railway will automatically set up all the necessary services and configurations for you.

What are the system requirements?

Railway handles all the infrastructure requirements. You only need a web browser to deploy and manage your application.

Is this template free to use?

Yes, this template is free to use within your existing Railway account.

Can I customize this template?

Yes, you can fully customize this template. After deployment, you will have full control of what you've deployed in your Railway project.

How do I get support for this template?

You can get support through our community forum: paperclip-07758d76, or click "Get template help" for this template for more assistance.

Deploy and Host Paperclip on Railway

Paperclip is open-source orchestration for running companies with AI agents. You define goals, hire agents (Claude, Codex, OpenClaw, and others), set budgets and heartbeats, and Paperclip coordinates work via org charts, ticketing, and governance so your business runs with minimal hands-on management.

About Hosting

This template gives you a one-click deploy: a Railway project with the Paperclip app (built from a pinned upstream release), a managed Postgres service, and a volume for app data. A lightweight wrapper serves a setup page at /setup where you generate your first admin invite and optionally authenticate Codex or Claude for agents. No SSH or log scraping—bootstrap is done in the browser. You set the required env vars (e.g. DATABASE_URL from Postgres, BETTER_AUTH_SECRET, PAPERCLIP_PUBLIC_URL), enable an HTTP proxy on port 3100, set the healthcheck path to /setup/healthz, and mount a volume at /paperclip. After that, create your first admin from the invite link and use Paperclip at / as usual.

Common Use Cases

Running an autonomous AI company with goals, org charts, heartbeats, and per-agent budgets
Coordinating multiple agents (Codex, Claude, OpenClaw, etc.) from one dashboard
Self-hosting Paperclip with managed Postgres and minimal ops

Dependencies for Paperclip Hosting

PostgreSQL — Railway Postgres is included in the template; the app uses it for auth and data
OpenAI API key (optional) — For agents using the Codex adapter; set OPENAI_API_KEY and run Codex login from /setup or let the wrapper run it at startup
Anthropic API key (optional) — For agents using the Claude adapter; set ANTHROPIC_API_KEY in Railway variables

Deployment Dependencies

Paperclip — upstream app and docs
Paperclip site — product overview
This template — source and support

Why Deploy

Railway is a singular platform to deploy your infrastructure stack. Railway will host your infrastructure so you don't have to deal with configuration, while allowing you to vertically and horizontally scale it.

By deploying Paperclip on Railway, you are one step closer to supporting a complete full-stack application with minimal burden. Host your servers, databases, AI agents, and more on Railway.