> ## Documentation Index
> Fetch the complete documentation index at: https://docs.simplehost.dev/llms.txt
> Use this file to discover all available pages before exploring further.

# Plans & Limits

> Compare Free and Hobby plans

## Plans

SimpleHost offers two plans:

<CardGroup cols={2}>
  <Card title="Free" icon="gift">
    **\$0/month** — Perfect for getting started.

    * 500 sites
    * 200 MB storage
    * 200 MB max file size
    * 1,000 files per site
    * 60 API requests/hour
  </Card>

  <Card title="Hobby" icon="rocket">
    **\$5/month** — For serious projects.

    * Unlimited sites
    * 100 GB storage
    * 5 GB max file size
    * 1,000 files per site
    * 1,000 API requests/hour
    * Custom handle
  </Card>
</CardGroup>

## Detailed Comparison

| Feature            | Free      | Hobby        |
| ------------------ | --------- | ------------ |
| **Sites**          | 500       | Unlimited    |
| **Storage**        | 200 MB    | 100 GB       |
| **Max file size**  | 200 MB    | 5 GB         |
| **Files per site** | 1,000     | 1,000        |
| **Handle**         | No        | Yes          |
| **API rate limit** | 60 req/hr | 1,000 req/hr |
| **Price**          | \$0       | \$5/month    |

## Anonymous Publishing Limits

Publishing without an API key has tighter limits:

| Feature     | Limit                  |
| ----------- | ---------------------- |
| Rate limit  | 5 requests/hour per IP |
| Site expiry | 24 hours               |
| Handle      | Not available          |

## Upgrading

You can upgrade to Hobby from the dashboard or directly from the terminal.

### From the dashboard

1. Go to [simplehost.dev/dashboard](https://simplehost.dev/dashboard)
2. Click the **Plan** tab
3. Click **Upgrade to Hobby**
4. Complete payment via Razorpay

### From the terminal

```bash theme={null}
# Get a checkout URL
curl -s -X POST https://simplehost.dev/api/billing/checkout \
  -H "Authorization: Bearer sh_live_your_key_here"

# Open the returned checkoutUrl in your browser to complete payment
```

Your limits are upgraded immediately after payment.

## Managing Everything from the Terminal

Every feature in SimpleHost can be managed from the terminal using curl commands -- no dashboard required:

* **Account info:** `GET /api/v1/account` -- check your plan, usage, and limits
* **Sites:** publish, update, list, delete, and duplicate sites via the API
* **Handle:** claim, view, and release your vanity subdomain via `GET/PUT/DELETE /api/v1/handle`
* **Billing:** upgrade and manage your subscription via `POST /api/billing/checkout` and `POST /api/billing/portal`

See the [API Reference](/api-reference/overview) for full details on every endpoint.

## What Happens If You Hit a Limit?

* **Site limit exceeded** — You'll receive a `SITE_LIMIT_EXCEEDED` error. Delete unused sites or upgrade.
* **Storage exceeded** — You'll receive a `STORAGE_EXCEEDED` error. Delete unused sites to free space or upgrade.
* **File too large** — You'll receive a `FILE_TOO_LARGE` error. Compress the file or upgrade for higher limits.
* **Rate limited** — You'll receive a `RATE_LIMITED` error. Wait for the reset window or upgrade.

All limits are enforced per-account, not per-site.