Skip to main content
Prisma Documentation Docs

Search documentation

Type to search this documentation.

On this pageOverview

dev

The prisma dev command starts a local Prisma Postgres database that you can run Prisma ORM commands against. Use it for development and testing, then point the same project at Prisma Postgres for production.

prisma dev [options]
Option Description Default
-n, --name Name of the server (helps isolate state between projects) default
-p, --port Main port number the Prisma Dev server will listen on 51213
-P, --db-port Port number the database server will listen on 51214
--shadow-db-port Port number the shadow database server will listen on 51215
-d, --detach Run the server in the background false
--debug Enable debug logging false
Command Description
prisma dev ls List available servers
prisma dev rm Remove servers
prisma dev start Start one or more stopped servers
prisma dev stop Stop servers
title="bun"
bunx prisma dev
pnpm
pnpm prisma dev
yarn
yarn prisma dev
npm
npx prisma dev

Output:

✔  Great Success!

   Your  prisma dev  server default is ready and listening on ports 63567-63569.

╭──────────────────────────────────╮

│[q]uit  [h]ttp url  [t]cp urls    │

╰──────────────────────────────────╯

Create a named instance for project isolation:

title="bun"
bunx prisma dev --name="mydbname"
pnpm
pnpm prisma dev --name="mydbname"
yarn
yarn prisma dev --name="mydbname"
npm
npx prisma dev --name="mydbname"

Run the server in the background:

title="bun"
bunx prisma dev --detach
pnpm
pnpm prisma dev --detach
yarn
yarn prisma dev --detach
npm
npx prisma dev --detach

This frees up your terminal. Use prisma dev ls to see running servers and prisma dev stop to stop them.

title="bun"
bunx prisma dev --port 5000 --db-port 5001 --shadow-db-port 5002
pnpm
pnpm prisma dev --port 5000 --db-port 5001 --shadow-db-port 5002
yarn
yarn prisma dev --port 5000 --db-port 5001 --shadow-db-port 5002
npm
npx prisma dev --port 5000 --db-port 5001 --shadow-db-port 5002
Suggest an edit

Propose a replacement for this page. The site team reviews it before applying any changes.

Export
Documentation menu