Prisma 7 setup paths (/docs/v7/getting-started)
For the complete Prisma documentation index, see llms.txt. A markdown version of any docs page is available by appending
.mdto its URL.
Choose the fastest path to start using Prisma ORM 7, Prisma Postgres, or Prisma Compute in a new or existing TypeScript project.
Location: v7 > Prisma 7 setup paths
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@prev init. This page collects the Prisma 7 starting points: start a new project, add Prisma to an existing one, then deploy.
[!NOTE] For a new project, Prisma 8 is the recommended path. It is the current major version of Prisma ORM. To start with Prisma 8, see the getting started page.
Start a new project
Section titled “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:
- Quickstart with PostgreSQL
- Quickstart with SQLite for a lightweight local setup
- Quickstart with MySQL
- Quickstart with MongoDB
Add Prisma to an existing project
Section titled “Add Prisma to an existing project”Use these guides if you already have an application or database and want to add Prisma ORM:
- Add Prisma ORM to an existing PostgreSQL project
- Add Prisma ORM to an existing MySQL project
- Add Prisma ORM to an existing SQLite project
- Add Prisma ORM to an existing MongoDB project
- Add Prisma ORM to an existing Prisma Postgres project
Deploy to Prisma Compute
Section titled “Deploy to Prisma Compute”Once your app runs locally, Prisma Compute runs it next to your Prisma Postgres database:
- Port the app to Prisma Composer: add a small TypeScript declaration around your server code, read the port from
service.port(), and bind credentials likeDATABASE_URLwithenvSecretin the service's input schema. Port an existing app covers the changes with complete declarations. - Sign in with
npx prisma@latest auth login. - Build your server bundle, then run
npx prisma@latest deploy module.tswithDATABASE_URLexported; the first deploy copies input values from your shell up to the deployment. See Deploying. - 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
Section titled “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:
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@prev 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@prev migrate dev --name init` and `npx prisma@prev 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
Section titled “Next steps”After setup, these pages are usually the next ones people need:
- Prisma Client overview
- Prisma Migrate getting started
- Prisma schema overview
- Open Prisma Studio to inspect and edit data visually
- Review pricing if you're evaluating Prisma Postgres for a team