Instagres

Instagres gives you an instant Postgres database with a single API call. No account required.

Your database expires after 72 hours unless you claim it to your Neon account. Databases are provisioned on AWS us-east-2 running Postgres 17.

Access it at instagres.com or neon.new.

Quick start

curl -X POST https://instagres.com/api/v1/database \
  -H 'Content-Type: application/json' \
  -d '{"ref": "your-app-name"}'

{
  "id": "01abc123-def4-5678-9abc-def012345678",
  "status": "UNCLAIMED",
  "neon_project_id": "cool-breeze-12345678",
  "connection_string": "postgresql://neondb_owner:npg_xxxx@ep-cool-breeze-pooler...",
  "claim_url": "https://instagres.com/claim/01abc123-def4-5678-9abc-def012345678",
  "expires_at": "2026-02-01T12:00:00.000Z",
  "created_at": "2026-01-29T12:00:00.000Z",
  "updated_at": "2026-01-29T12:00:00.000Z"
}

Limits

Unclaimed databases have stricter quotas. Claiming resets limits to your Neon plan.

Claiming a database

Claiming is optional. Your database works immediately. Claim only if you want to keep it beyond 72 hours.

To claim:

1. Visit the claim_url from the API response
2. Sign in to Neon (or create an account)
3. Choose an organization for the database
4. Complete the transfer

After claiming, the database appears in your Neon console with expiration removed. The status changes to CLAIMED and connection_string becomes null in the API (use Neon console instead).

API

The Instagres API provides programmatic database provisioning. No authentication required.

Base URL: https://instagres.com/api/v1

Create database

POST /api/v1/database

Get database

GET /api/v1/database/:id

Returns the same response schema.

Response fields

Command-line interface

The get-db CLI creates a database and writes credentials to your .env file:

npx get-db

Options:

Example output in .env:

# Claimable DB expires at: Sat, 01 Feb 2026 12:00:00 GMT
# Claim it now to your account: https://instagres.com/claim/01abc123-def4-5678-9abc-def012345678
DATABASE_URL=postgresql://neondb_owner:npg_xxxxxxxxxxxx@ep-cool-breeze-a1b2c3d4-pooler.c-2.us-east-2.aws.neon.tech/neondb?channel_binding=require&sslmode=require
DATABASE_URL_DIRECT=postgresql://neondb_owner:npg_xxxxxxxxxxxx@ep-cool-breeze-a1b2c3d4.c-2.us-east-2.aws.neon.tech/neondb?channel_binding=require&sslmode=require
PUBLIC_INSTAGRES_CLAIM_URL=https://instagres.com/claim/01abc123-def4-5678-9abc-def012345678

To claim, visit the URL in the comments above or run npx get-db claim to open it in your browser.

Vite plugin

Add automatic database provisioning to Vite projects with vite-plugin-db:

npm install -D vite-plugin-db

import { postgres } from 'vite-plugin-db';
import { defineConfig } from 'vite';

export default defineConfig({
  plugins: [
    postgres({ referrer: 'your-app-name' }),
  ],
});

The plugin provisions a database on first vite dev if DATABASE_URL is missing. It's inactive during vite build.

Additional options:

// Inside defineConfig({ plugins: [...] })
postgres({
  referrer: 'your-app-name', // Required
  dotEnvFile: '.env.local', // Default: .env
  dotEnvKey: 'DATABASE_URL', // Default: DATABASE_URL
  envPrefix: 'VITE_', // For public env vars
  seed: {
    type: 'sql-script',
    path: './schema.sql',
  },
})

Resources

• Instagres website
• get-db CLI on GitHub
• Vite Plugin on GitHub
• Claimable database integration (build your own Instagres-like experience)