Skip to main content

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

SimpleHost offers two plans:

Free

$0/month — Perfect for getting started.
  • 500 sites
  • 10 GB storage
  • 250 MB max file size
  • 1,000 files per site
  • 60 API requests/hour

Hobby

$5/month — For serious projects.
  • Unlimited sites
  • 100 GB storage
  • 5 GB max file size
  • 1,000 files per site
  • 200 API requests/hour
  • Custom handle

​
Detailed Comparison

FeatureFreeHobby
Sites500Unlimited
Storage10 GB100 GB
Max file size250 MB5 GB
Files per site1,0001,000
HandleNoYes
API rate limit60 req/hr200 req/hr
Price$0$5/month

​
Anonymous Publishing Limits

Publishing without an API key has tighter limits:
FeatureLimit
Rate limit5 requests/hour per IP
Site expiry24 hours
HandleNot available

​
Upgrading

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

​
From the dashboard

  1. Go to simplehost.dev/dashboard
  2. Click the Plan tab
  3. Click Upgrade to Hobby
  4. Complete payment via Razorpay

​
From the terminal

# 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 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.