Skip to content
Last updated on February 8, 2023
1 min read

Deploying Projects from Vercel CLI

Learn how to deploy your Vercel Projects from Vercel CLI using the vercel or vercel deploy commands.

The vercel command is used to deploy Vercel Projects and can be used from either the root of the Vercel Project directory or by providing a path.


Deploys the current Vercel project, when run from the Vercel Project root.

You can alternatively use the vercel deploy command for the same effect, if you want to be more explicit.

vercel [path-to-project]

Deploys the Vercel project found at the provided path, when it's a Vercel Project root.

When deploying, stdout is always the Deployment URL.

vercel > deployment-url.txt

Writes the Deployment URL output from the deploy command to a text file.

You can build Vercel projects locally to inspect the build outputs before they are deployed. This is a great option for producing builds for Vercel that do not share your source code with the platform.

It's also useful for debugging build outputs.

vercel build

Using the vercel command to deploy and write stdout to a text file.

This produces .vercel/output in the Build Output API format. You can review the output, then deploy with:

vercel deploy --prebuilt

Deploy the build outputs in .vercel/output produced by vercel build.

See more details at Build Output API.