Skip to content
Browse docs

Projects

A project is the top-level container for everything you deploy: each one holds your PocketBase instances, backends, and frontends.

Sign up

Sign in at the PocketBase Cloud portal with your Google account. Your first project is created for you on signup, so there is nothing to set up before your first deploy.

Then open the Plan page and subscribe:

  • Free ($0) — 1 PocketBase instance and frontend hosting. A card is required, but you are never charged.
  • Starter ($10/mo) — 1 instance, frontend hosting, a separate server cluster, and custom domains.
  • Pro ($25/mo flat) — your own dedicated compute (2 vCPU) in a region you choose, backend hosting, and effectively unlimited instances, backends, and frontends.

Starter and Pro can also be billed yearly at two months free — see Yearly billing.

pbc whoami shows your plan, and pbc plan links you to the portal to change it.

Select or add a project

The project from signup is enough for most apps. There is nothing to select first: the first deploy asks which project to use and records the choice in pbc.json alongside the resource.

To choose a default ahead of time, or see what exists:

pbc login
pbc project ls             # your projects
pbc project use <name>     # make one the default for later commands

Need another one? Create it in the portal under Projects → New Project, or with pbc project create my-app.

Next steps