Skip to content

Commit d344441

Browse files
committed
fix: update docs
1 parent d537bbf commit d344441

File tree

2 files changed

+27
-7
lines changed

2 files changed

+27
-7
lines changed

content/200-orm/500-reference/200-prisma-cli-reference.mdx

Lines changed: 17 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -879,9 +879,23 @@ Fetching latest updates for this subcommand...
879879

880880
</CodeWithResult>
881881

882+
**Run `prisma dev` with a specific name**
883+
884+
```terminal
885+
npx prisma dev --name="mydbname"
886+
```
887+
888+
This creates a named instance called `mydbname` that you can later start, stop, or manage using the instance management commands.
889+
882890
### `dev start`
883891

884-
Starts existing [local Prisma Postgres](/postgres/database/local-development) instances in the background:
892+
Starts existing [local Prisma Postgres](/postgres/database/local-development) instances in the background.
893+
894+
:::note
895+
896+
This command only works with instances that already exist.
897+
898+
:::
885899

886900
```terminal
887901
npx prisma dev start <glob>
@@ -890,13 +904,13 @@ npx prisma dev start <glob>
890904
`<glob>` is a placeholder for a glob pattern to specify which local Prisma Postgres instances should be started, for example:
891905

892906
```terminal
893-
npx prisma dev start mydb # starts a DB called `mydb` in the background if it already exists
907+
npx prisma dev start mydb # starts a DB called `mydb` in the background (only if it already exists)
894908
```
895909

896910
To start all databases that begin with `mydb` (e.g. `mydb-dev` and `mydb-prod`), you can use a glob:
897911

898912
```terminal
899-
npx prisma dev start mydb* # starts all DBs starting with `mydb`
913+
npx prisma dev start mydb* # starts all existing DBs starting with `mydb`
900914
```
901915

902916
This enables background instance management outside of the VS Code extension.

content/250-postgres/300-database/550-local-development.mdx

Lines changed: 10 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -83,10 +83,10 @@ To transition to production, you only need to update the database URL in the `.e
8383
You can target a specific, local Prisma Postgres instance via the `--name` (`-n`) option of the `prisma dev` command, for example:
8484

8585
```terminal
86-
npx prisma dev --name mydb1
86+
npx prisma dev --name="mydb1"
8787
```
8888

89-
Whenever you pass the `--name mydb1` to `prisma dev`, the command will return the same connection string pointing to a local instance called `mydb1`.
89+
Whenever you pass the `--name="mydb1"` to `prisma dev`, the command will return the same connection string pointing to a local instance called `mydb1`. This creates a named instance that you can later manage using the instance management commands.
9090

9191
## Starting existing Prisma Postgres instances in the background
9292

@@ -96,16 +96,22 @@ You can start existing Prisma Postgres instances in the background using:
9696
npx prisma dev start <glob>
9797
```
9898

99+
:::note
100+
101+
The `dev start` command only works with instances that already exist.
102+
103+
:::
104+
99105
`<glob>` is a placeholder for a glob pattern to specify which local Prisma Postgres instances should be started, for example:
100106

101107
```terminal
102-
npx prisma dev start mydb # starts a DB called `mydb` in the background
108+
npx prisma dev start mydb # starts a DB called `mydb` in the background (only if it already exists)
103109
```
104110

105111
To start all databases that begin with `mydb` (e.g. `mydb-dev` and `mydb-prod`), you can use a glob:
106112

107113
```terminal
108-
npx prisma dev start mydb* # starts all DBs starting with `mydb`
114+
npx prisma dev start mydb* # starts all existing DBs starting with `mydb`
109115
```
110116

111117
This command enables you to manage Prisma Postgres instances outside of the VS Code extension, allowing for background instance management in your development workflow.

0 commit comments

Comments
 (0)