Koo Docs
View as Markdown

Billing & plans

Koo bills per account: a plan (Free, Plus, or Pro), seats, and the services you run. The Free plan and the always-free allowance are fully live today; self-service plan management is rolling out and marked below.

How your bill is computed

Koo bills in two separate parts: your subscription in advance, and compute in arrears.

Your subscription — plan + seats, up front. A flat amount for your tier, plus any members beyond the plan's included seat count (billed per seat). You pay this at the start of each period, and a hosted checkout charges only this. Plans bill monthly or annually; annual is about 17% off, applied to the plan and seat lines only.

Compute — what your services run, monthly in arrears. Each running service accrues its monthly price — set by its CPU and memory — × the fraction of the month it actually ran — run a service for half the month and pay half; suspended time doesn't accrue. At the end of each month that total is billed, after two deductions applied in order:

  1. The in-kind free allowance — one free 0.5 vCPU / 1 GiB service of each type (web, Postgres, Redis) on your primary account, applied to your largest running service of that type. See Free tier & pricing.
  2. Your plan's compute credit — a fixed dollar amount included each month (shown as Monthly compute credit in the comparison below), applied after the allowance. It doesn't roll over, and annual plans still get it every month — compute always bills monthly, in arrears, at full rate.

Symbolically, the compute charge is max(0, Σ price(service) × fraction run − allowance − credit).

If that works out to $0 — a common outcome within the allowance and credit — Koo still cuts a real invoice for $0; it simply charges nothing. On the Free plan, compute never exceeds the allowance, so there is no charge and no payment method is required.

Compare plans

Plans differ in seats, app and resource ceilings, features, and log and metrics retention. Every number renders live from the current pricing config:

FreePlusProEnterprise
Base price$0$20/mo · $200/yr$60/mo · $600/yrContact sales
Seats included13 (extra $8/mo)10 (extra $6/mo)25
Monthly compute credit$20/mo$60/moContact sales
Projects110UnlimitedUnlimited
Locations per service12510
Free web service0.5 vCPU / 1 GiB0.5 vCPU / 1 GiB0.5 vCPU / 1 GiB0.5 vCPU / 1 GiB
Free Postgres0.5 vCPU / 1 GiB0.5 vCPU / 1 GiB0.5 vCPU / 1 GiB0.5 vCPU / 1 GiB
Free Redis0.5 vCPU / 1 GiB0.5 vCPU / 1 GiB0.5 vCPU / 1 GiB0.5 vCPU / 1 GiB
Custom domains325100
Auto-deploy from Git
Priority support
Log / metrics retention1 d7 d30 d90 d
Deployment history10 versions30 versions100 versions500 versions

Service pricing

Every service picks explicit CPU and memory from a discrete ladder (memory up to 8 GiB per vCPU) and bills a predictable monthly price, linear in CPU + memory. Postgres and Redis price their compute the same way, with disk provisioned separately as a volume — see Postgres and Redis.

Pick any CPU + memory (memory up to 8 GiB per vCPU).
vCPUMemoryPrice
0.25 vCPU512 MiB$5/mo
0.5 vCPU1 GiB$10/mo
1 vCPU2 GiB$20/mo
2 vCPU4 GiB$40/mo
4 vCPU8 GiB$80/mo

The free allowance

Your primary account permanently includes one free web service, one free Postgres, and one free Redis, each at the free unit (0.5 vCPU / 1 GiB). The allowance is a price deduction, not a reserved shape: upsize a covered service and it bills only the difference — price(service) − price(free unit). See Free tier & pricing for the full rules.

Today the Free plan's resource ceilings cap at exactly the allowance: you can run the free-unit services, but upsizing beyond them requires a paid plan until self-service checkout ships.

Upgrade Coming soon

Self-service upgrade will work from the account's billing settings:

  1. Choose a plan and a cadence — monthly or annual (annual is about 17% off).
  2. Complete payment in a hosted checkout page.
  3. Your plan switches as soon as the subscription activates, and the new ceilings apply immediately.

Upgrading mid-period will prorate: you'll be charged the difference for the remainder of the period right away. Your free allowance carries over unchanged — paid plans always include at least the Free allowance.

Downgrade Coming soon

If your current usage fits the lower plan's limits, a downgrade will apply immediately, with the unused difference credited toward your next invoice.

If usage exceeds the lower plan — too many services, resources above its ceilings, more seats than it includes — the downgrade will pause and show you what's over the limit. You'll then either:

  • Pick yourself — choose which services to shrink or delete and which members to remove, then resubmit.
  • Auto-shrink — let Koo reduce usage deterministically: step services down the resource ladder, reduce replicas, suspend the lowest-traffic extras, and deactivate the most recently added members (the owner is always retained).

Auto-shrink makes destructive changes — it can suspend services and deactivate members. Every change is recorded in the account's audit events.

Cancel & refunds Coming soon

Monthly subscriptions: canceling will keep your paid plan active until the end of the current period, then revert the account to Free. There's no mid-period cash refund on your plan; the free allowance keeps your covered services running at $0.

Annual subscriptions canceled mid-term: you'll receive a prorated cash refund of your plan and seats at the monthly-equivalent rate — you pay the regular monthly price for the months you actually used and get the remainder back: refund = amountPaid − monthsUsed × monthlyPrice, never below zero. Late in the term, once the monthly-rate value used exceeds what you paid, no refund remains.

Compute is settled separately either way: the compute you've already used is billed once more at the end of the month, as usual — a final compute invoice — and then nothing further.

If a renewal payment fails, you'll be notified and the charge retried automatically; if retries are exhausted the account is suspended until a payment succeeds, then restored.

Deleting your account cancels its subscription the same way, refund included — see account deletion.

Price changes

When Koo changes prices, the new prices apply to new subscriptions only. Existing subscriptions keep their current prices for a 12-month grandfathering window from the date of the change, and you're notified before your subscription migrates to the new prices at the window's end.