Workspaces and billing
Members and roles, the subscription, metered usage, the overage cap, and what pier billing shows
A workspace is the account: its members, its subscription, its usage and its bill. Projects live inside it. Most people have one.
pier whoamiName Pier Admin
Email admin@pier.run
ID usr_01kxv2zrb3fvnr80vbch4y5b6r
Created 2026-07-19 01:04:37
Controller https://api.pier.run
Profile local
CLI Version dev-da2bbfc-dirty-0830-2236
pier workspaces ls
NAME SLUG ROLE ID
* hello hello-a2cb owner ws_01ky4wcrsne6s8gtm3jdpaj2tw
smoke smoke-12b5 owner ws_01kxw3y21tehm9qm0mha3k125j
Roles
Roles inherit upward: owner > admin > developer > viewer.
| Role | Can |
|---|---|
viewer | read everything: resources, deploys, logs, events, metrics, billing |
developer | create and change resources and variables, deploy, restart, pause, pier ssh, pier psql, bucket objects |
admin | delete resources, projects and environments; change workspace settings; manage members |
owner | delete the workspace; change the subscription and payment |
A command that needs more than your role fails with 403 and says which role it needs.
Members are managed in the console.
What is billed
| Item | Meter |
|---|---|
| app targets | plan × replicas × hours (an autoscaled target bills the replicas it ran) |
| Postgres instances | plan × hours, plus storage |
| volumes | storage |
| buckets | storage and egress through the bucket hostname |
| sites | edge egress |
| builds | build minutes |
Paused apps and Postgres bill storage only. Removed resources bill storage until purged. Usage is recorded continuously and invoiced at the end of each billing period against the plan's included amounts; the plan fee and prices are on pier.run and in the console.
pier billing overviewPlan Pro
Status active
Period 2026-08-22T14:25:22Z → 2026-09-22T14:25:22Z
Active resources 17
Plan fee $20.00/mo
pier billing charges lists recent invoices.
The cap
An overage cap limits what a period's metered usage may cost beyond the plan. The
platform warns at 50 % and 80 % and, at 100 %, either notifies (notify_only) or pauses the
workspace (hard_suspend, the default) until the cap is raised or the period rolls over.
pier billing cap show
pier billing cap set 50 --action hard_suspend
pier billing cap remove # unlimitedPayment and trials
- A failed payment is retried; after seven days past due the workspace is paused and, after 30 more days, purged. Paying the invoice resumes it.
- A trial workspace has a grant and a 14-day window; when either runs out it is paused with a 7-day recovery window. Choosing a plan resumes it.
- A warning email is sent five days before any purge.
See also
Pause and resume · pier billing ·
pier workspaces · Concepts: workspace