Skip to main content

Quick Start

Create a PostgreSQL service and connect to it in under 5 minutes.

1. Create a service​

curl -u admin:password -X POST https://api.foundrydb.com/managed-services \
  -H "Content-Type: application/json" \
  -d '{
    "name": "my-first-db",
    "database_type": "postgresql",
    "version": "17",
    "plan_name": "tier-2",
    "zone": "se-sto1",
    "storage_size_gb": 50,
    "storage_tier": "maxiops"
  }'

The response includes the service id. Provisioning takes 3–5 minutes.

2. Check status​

curl -u admin:password https://api.foundrydb.com/managed-services/{id}

Wait until status is running.

3. Allow your IP​

curl -u admin:password -X PATCH https://api.foundrydb.com/managed-services/{id} \
  -H "Content-Type: application/json" \
  -d '{"allowed_cidrs": ["YOUR_IP/32"]}'

4. Get credentials​

# List users
curl -u admin:password https://api.foundrydb.com/managed-services/{id}/database-users

# Reveal password
curl -u admin:password -X POST \
  https://api.foundrydb.com/managed-services/{id}/database-users/{username}/reveal-password

5. Connect​

PGPASSWORD=your_password psql \
  "host=my-first-db.db.foundrydb.com \
   user=app_user \
   dbname=defaultdb \
   sslmode=verify-full"

Next steps​