Prisma ORM 8 is here.Read the docs
Prisma home/docsPrisma documentation home
Login
V7

Prisma 7 setup paths

Prisma ORM v7

Choose the fastest path to start using Prisma ORM 7, Prisma Postgres, or Prisma Compute in a new or existing TypeScript project.

Prisma 7 remains fully supported; Prisma 8 is the current release of Prisma ORM. Scaffold a new Prisma 7 app with npx create-prisma@stable, or add it to an existing project with npx prisma@7.10.0 init. This page collects the Prisma 7 starting points: start a new project, add Prisma to an existing one, then deploy.

Start a new project

The recommended path is the Quickstart with Prisma Postgres: it provisions a managed PostgreSQL database for you and gets you from install to first query in about five minutes.

To work with a specific database instead, pick its quickstart:

Add Prisma to an existing project

Use these guides if you already have an application or database and want to add Prisma ORM:

Deploy to Prisma Compute

Once your app runs locally, Prisma Compute runs it next to your Prisma Postgres database:

  1. Port the app to Prisma Composer: add a small TypeScript declaration around your server code, read the port from service.port(), and bind credentials like DATABASE_URL with envSecret in the service's input schema. Port an existing app covers the changes with complete declarations.
  2. Sign in with npx prisma@latest auth login.
  3. Build your server bundle, then run npx prisma@latest deploy module.ts with DATABASE_URL exported; the first deploy copies input values from your shell up to the deployment. See Deploying.
  4. Keep deploying from the CLI, or connect GitHub to deploy on push.

For a worked example, from scratch or from an app you already have, follow Deploy your first app.

Use with your agent

To hand the full Prisma 7 stack to your coding agent, copy this prompt. The commands below install Prisma 7, not Prisma 8:

Use with your agent
Use with your agent
Set up the Prisma 7 stack: Prisma ORM 7, Prisma Postgres, and Prisma Compute.

If I have not told you which framework template to use, stop and ask.

1. Scaffold a new app non-interactively: `npx create-prisma@stable --name my-app --template [next|hono|nuxt|astro|nest|svelte|tanstack-start|elysia|turborepo] --provider postgresql --no-deploy`. Or add Prisma 7 to an existing app with `npx prisma@7.10.0 init --db`, which provisions a Prisma Postgres database and may open a browser to sign in; if it does, stop and ask me to complete the sign-in.
2. From the project directory, define a small schema in `prisma/schema.prisma`, then run `npx prisma migrate dev --name init` and `npx prisma generate`. If migrate dev asks to reset the database, stop and ask me first.
3. Update the seed and app code to query the schema, and verify locally with the dev script.
4. Deploy with Prisma Compute: port the app to Prisma Composer following https://www.prisma.io/docs/composer/porting-an-app.md — declare the service around the existing server, read the port from `service.port()` and bind 0.0.0.0, bind `DATABASE_URL` with `envSecret` in the service input, and produce one self-contained entry file. Check `npx prisma@latest auth whoami`. If I am not signed in, stop and ask me to run `npx prisma@latest auth login`, because that step opens a browser. Then run the build followed by `npx prisma@latest deploy module.ts` with `DATABASE_URL` exported so the first deploy copies it up, and verify the deployed URL with curl.

Current docs: https://www.prisma.io/docs/v7/getting-started.md and https://www.prisma.io/docs/llms.txt.

Next steps

After setup, these pages are usually the next ones people need:

Edit on GitHub

Prisma Postgres

Create a new TypeScript project from scratch by connecting Prisma ORM to Prisma Postgres and generating a Prisma Client for database access

On this page

Start a new projectAdd Prisma to an existing projectDeploy to Prisma ComputeUse with your agentNext steps