# Self-hosting overview

> Run your own copy of planpage on your Cloudflare account. What you need, what it costs, and how it differs from planpa.ge.

planpage is open source under the [GNU AGPL-3.0](https://github.com/Bifrostdotgg/planpage/blob/master/LICENSE). You can run the same app that serves planpa.ge on your own Cloudflare account, with your own database, storage and sign-in. Your documents never touch our servers.

If you just want to use planpage, the hosted version at [app.planpa.ge](https://app.planpa.ge) is quicker: there is nothing to install or update.

## What it runs on

planpage is one Cloudflare Worker. Everything it keeps lives in your account:

| Piece | Cloudflare product | What it holds |
| --- | --- | --- |
| The app | Workers (with static assets) | Pages, the REST API, the MCP server, share pages and these docs |
| Database | D1 | Accounts, teams, workspaces, documents, comments and recent activity |
| Live editing | Durable Objects | Co-editing rooms, the live inbox, imports and moving documents between databases |
| Files | R2 | Every version's text, uploaded images, rendered diagrams, and activity older than 90 days |
| Agent sign-in | KV | OAuth state for agents connecting over MCP |
| Optional | Browser Run (formerly Browser Rendering) | Diagram images and link preview cards |

## What you need

- A Cloudflare account on the **Workers Paid** plan, which [starts at $5 a month](https://developers.cloudflare.com/workers/platform/pricing/). The free plan allows 10 ms of CPU time per request, and opening or saving a long document needs more. Cloudflare bills usage above the included amounts.
- A domain on that Cloudflare account, for the app and its share pages.
- A way for people to sign in: an SMTP server for email sign-in links, or a GitHub or Discord OAuth app, or both.
- Node.js 22 or later, pnpm 10 and git on the machine you deploy from.

## How it differs from planpa.ge

- **Every feature is on.** Billing is off unless you turn it on, so every workspace gets every feature with no plan limits.
- **You are the admin.** The first person to sign in with an address you list becomes superadmin, and gets **Admin** for users, system settings, email and the audit log.
- **No front page.** By default your app host serves the app, these docs and share pages. The marketing site only appears if you give it a host of its own.
- **You update it.** New versions arrive as commits to the repository. You pull and deploy them when it suits you. See [Updating](https://planpa.ge/docs/self-host-update.md).

## The AGPL in practice

You can run, change and share planpage freely. If you change it and let other people use your changed version over a network, you have to offer them your changed source code under the same licence. Running it unchanged for your team, or keeping changes to yourself and people inside your organization, needs nothing from you.

The planpage name and logo are trademarks of Bifrost Development Ltd. If you run a public, changed copy, call it something else.

## Next

1. [Install](https://planpa.ge/docs/self-host-install.md) walks through creating the resources and deploying.
2. [Configure](https://planpa.ge/docs/self-host-configure.md) covers sign-in, email, the GitHub App, push notifications and custom share domains.
3. [Updating](https://planpa.ge/docs/self-host-update.md) and [Troubleshooting](https://planpa.ge/docs/self-host-troubleshooting.md) are for later.
4. [Scaling the database](https://planpa.ge/docs/self-host-scaling.md) explains when one database stops being enough, which for most teams is never.
