Getting Started
Quick Start

Quick Start

Create your first PostgreSQL database in minutes.

Create an Account

Sign up at console.cloudheed.com (opens in a new tab) or use the API:

curl -X POST https://api.cloudheed.com/v1/auth/register \
  -H "Content-Type: application/json" \
  -d '{
    "email": "[email protected]",
    "password": "securepassword123",
    "name": "Your Name"
  }'

Get Your API Token

Login to receive a JWT token:

curl -X POST https://api.cloudheed.com/v1/auth/login \
  -H "Content-Type: application/json" \
  -d '{
    "email": "[email protected]",
    "password": "securepassword123"
  }'

Response:

{
  "token": "eyJhbGciOiJIUzI1NiIs...",
  "user": {
    "id": "550e8400-e29b-41d4-a716-446655440000",
    "email": "[email protected]"
  }
}

Create a Database

curl -X POST https://api.cloudheed.com/v1/databases \
  -H "Authorization: Bearer YOUR_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "my-app-db",
    "region": "fsn1",
    "tier": "micro",
    "version": "17"
  }'

Response:

{
  "id": "db-abc123",
  "name": "my-app-db",
  "host": "db-abc123.db.cloudheed.cloud",
  "port": 5432,
  "username": "cloudheed",
  "password": "generated-password",
  "connection_string": "postgresql://cloudheed:[email protected]:5432/postgres?sslmode=require"
}
⚠️

Save the password! It's only shown once when the database is created.

Connect to Your Database

psql "postgresql://cloudheed:[email protected]:5432/postgres?sslmode=require"

Available Regions

Region IDLocation
fsn1Falkenstein, Germany
nbg1Nuremberg, Germany
hel1Helsinki, Finland
ashAshburn, Virginia, USA
hilHillsboro, Oregon, USA
sinSingapore

Database Tiers

TiervCPUMemoryStorageConnectionsPrice/mo
free0.25 shared256 MB500 MB3€0
micro2 shared1 GB10 GB60€19.99
small2 shared2 GB20 GB90€39.99
medium2 shared4 GB40 GB120€79.99
large4 dedicated8 GB80 GB160€149.99
xl4 dedicated16 GB160 GB240€299.99
2xl8 dedicated32 GB245 GB380€449.99
4xl16 dedicated64 GB368 GB480€899.99
8xl32 dedicated128 GB600 GB600€1,799.99

Next Steps