# Billing and limits

keel.run has no free tier. Every plan has a small base price that includes usage of the same value; beyond that, usage is billed by the hour. All prices are in euros and **include VAT**. The [pricing page](/pricing) has a calculator.

## Plans

| | Hobby | Pro |
|---|---|---|
| Base price per month | €5 | €20 |
| Usage included | €5 | €20 |
| Projects | 10 | 50 |
| Services | 20 | 100 |
| Databases | 5 | 25 |
| Instances per service | 3 | 10 |
| Log retention | 7 days | 30 days |
| Build time limit | 20 min | 30 min |
| Concurrent builds | 1 | 3 |
| `xl` instances, HA databases (`pg-m-ha`) | – | ✓ |

## Trial

The first subscription of a workspace starts with a **7-day trial** that includes **€5 of usage**. A card is required to start it – this keeps out the abuse that free plans attract. You are not charged during the trial, and usage in the trial is never billed.

- If the trial credit is used up before the trial ends, your apps pause until you end the trial.
- End the trial early in the dashboard under **Billing** or with `POST /v1/workspaces/{id}/billing/end-trial`; the paid plan starts at once.
- Cancel before the trial ends and you pay nothing.

Without a subscription, a workspace can create projects but no services, deployments or databases (the API answers `402 billing_required`).

New workspaces have lower limits for their first 14 days: at most 2 services and instance sizes up to `m`.

## Usage prices

| Resource | Price per month | Billed by |
|---|---|---|
| vCPU | €10 per vCPU | actual use, measured every minute |
| RAM | €7 per GB | reservation: instance size × instances, or the database plan's RAM × instances |
| Database storage | €0.20 per GB | size of the database volumes, also while paused |
| Backup storage | €0.05 per GB | size of the backups |
| Mailbox | €1.50 per mailbox | each mailbox, including 5 GB of storage pooled across the workspace |
| Mail storage | €0.10 per GB | storage above 5 GB × mailboxes |
| App mails | €0.40 per 1,000 | recipients of mail sent with [sending keys](/docs/mail-sending) (not monthly) |
| Inbound mail webhooks | €0.10 per 1,000 | mails posted to your app by inbound routes (not monthly) |

Monthly prices are converted to hourly ones with 730 hours per month. Usage is summed per hour, and only the part above your plan's included amount is billed at the end of the billing period.

**Example:** an app with size `s` (512 MB) that runs all month and uses 5 % of a vCPU on average costs 0.5 × €7 + 0.05 × €10 = €4 of usage. That is within the €5 included in Hobby, so the month costs €5.

Your current usage and a projection for the period are in the dashboard under **Billing** and in the API (`GET /v1/workspaces/{id}/usage`, scope `billing:read`).

## Spend limits

A spend limit caps what a workspace can cost per billing period: the base price plus usage above the included amount.

- At **80 %**, the workspace owners get an e-mail (once per period).
- At **100 %**, the workspace is **suspended**: apps are scaled to zero and databases are paused. **No data is deleted**, and storage keeps being billed.
- Raise or remove the limit at any time – also while suspended – and everything starts again right away. A new billing period lifts the suspension too.

```bash
curl -X PUT https://api.keel.run/v1/workspaces/ws_…/billing/spend-limit \
  -H "Authorization: Bearer $KEEL_TOKEN" -H "Content-Type: application/json" \
  -d '{"spend_limit_cents": 2500}'
```

While a workspace is at its limit, actions that would cost more (new services, deployments, databases, scaling, domains) answer `402 spend_limit_reached`. Deleting things always works.

## Payment

Payments are processed by Stripe. Invoices include VAT; businesses in the EU with a valid VAT ID are billed under the reverse-charge procedure. Change your card, download invoices or cancel in the billing portal, which you open from **Billing** in the dashboard.

If a payment fails, Stripe retries it. If it is still unpaid 7 days after the first failure, the workspace is suspended in the same way as at a spend limit, until the invoice is paid.
