TurboJet
DatabaseDatabase providers

Local (Docker)

PostgreSQL 15 via docker-compose — the recommended local default.

The recommended database for local development is Postgres 15 from docker-compose.yml.

SettingDefault
Imagepostgres:15
Useradmin
Passwordroot
Databaseturbojet
Host port${POSTGRES_PORT:-5432}

Compose also starts Mailpit for email testing. See Environment for DATABASE_URL, DIRECT_URL, and POSTGRES_PORT.

1. Start containers

pnpm docker:up

2. Configure environment variables

For local Docker, DATABASE_URL and DIRECT_URL can be the same connection string:

DATABASE_URL="postgresql://admin:root@localhost:5432/turbojet"
DIRECT_URL="postgresql://admin:root@localhost:5432/turbojet"

Adjust the port if you set POSTGRES_PORT.

3. Migrate and generate

pnpm prisma:migrate
pnpm --filter @repo/database db:generate

Optional seed (verified onboarded users):

pnpm --filter @repo/database db:seed

4. Verify

pnpm --filter @repo/database db:studio
# or
pnpm dev

Pooled hosts

Managed providers (Neon, Supabase) use a pooled URL for DATABASE_URL and a direct URL for DIRECT_URL. Migrate scripts temporarily set DATABASE_URL to DIRECT_URL. See Neon and Supabase.

Use database client

Query and mutate data with db from @repo/database.

Neon Postgres

Serverless Postgres with connection pooling and branching for TurboJet.

On this page

1. Start containers2. Configure environment variables3. Migrate and generate4. VerifyRelated