vercel dev

Learn how to replicate the Vercel deployment environment locally and test your Vercel Project before deploying using the vercel dev CLI command.

The vercel dev command is used to replicate the Vercel deployment environment locally, allowing you to test your Vercel Functions and Edge Middleware without requiring you to deploy each time a change is made.

If the Development Command is configured in your Project Settings, it will affect the behavior of vercel dev for everyone on that team.

Before running vercel dev, make sure to install your dependencies by running npm install.

When to Use This Command

If you're using a framework and your framework's Development Command already provides all the features you need, we do not recommend using vercel dev.

For example, Next.js's Development Command (next dev) provides native support for Functions, redirects, rewrites, headers and more.

Usage

terminal
vercel dev

Using the vercel dev command from the root of a Vercel Project directory.

Unique Options

These are options that only apply to the vercel dev command.

Listen

The --listen option, shorthand -l, can be used to specify which port vercel dev runs on.

terminal
vercel dev --listen 5005

Using the vercel dev command with the --listen option.

Yes

The --yes option can be used to skip questions you are asked when setting up a new Vercel Project. The questions will be answered with the default scope and current directory for the Vercel Project name and location.

terminal
vercel dev --yes

Using the vercel dev command with the --yes option.

Global Options

The following global options can be passed when using the vercel dev command:

For more information on global options and their usage, refer to the options section.

Last updated on March 4, 2025
Next
Account Management