Vercel

Complete Vercel CLI reference and documentation access.

When to Use

• Deploying applications to Vercel
• Managing projects, domains, and environment variables
• Running local development server
• Viewing deployment logs and status
• Looking up Vercel documentation

---

Documentation

Fetch any Vercel docs page as markdown:

curl -s "" -H 'accept: text/markdown'

Get the full sitemap to discover all available pages:

curl -s "" -H 'accept: text/markdown'

---

CLI Commands

Deployment

vercel / vercel deploy [path]

Deploy the current directory or specified path.

Options:

• --prod - Deploy to production


• -e KEY=VALUE - Set runtime environment variables


• -b KEY=VALUE - Set build-time environment variables


• --prebuilt - Deploy prebuilt output (use with vercel build)


• --force - Force new deployment even if unchanged


• --no-wait - Don't wait for deployment to finish


• -y, --yes - Skip prompts, use defaults

Examples:

vercel                          # deploy current directory
vercel --prod                   # deploy to production
vercel /path/to/project         # deploy specific path
vercel -e NODE_ENV=production   # with env var
vercel build && vercel --prebuilt  # prebuilt deploy

vercel build

Build the project locally into ./vercel/output.

vercel build

vercel dev [dir]

Start local development server.

Options:

• -l, --listen - Port/address (default: 0.0.0.0:3000)

Examples:

vercel dev                  # start on port 3000
vercel dev --listen 8080    # start on port 8080

---

Project Management

vercel link [path]

Link local directory to a Vercel project.

Options:

• -p, --project - Specify project name


• -y, --yes - Skip prompts

Examples:

vercel link
vercel link --yes
vercel link -p my-project

vercel projects

Manage projects.

vercel projects list              # list all projects
vercel projects add <name>        # create new project
vercel projects inspect [name]    # show project details
vercel projects remove <name>     # delete project

vercel pull [path]

Pull project settings and env vars from cloud.

vercel pull

---

Environment Variables

vercel env

Manage environment variables.

vercel env list [environment]                    # list env vars
vercel env add <name> [environment]              # add env var
vercel env remove <name> [environment]           # remove env var
vercel env pull [filename]                       # pull to .env.local

Environments: development, preview, production

Examples:

vercel env list production
vercel env add DATABASE_URL production
vercel env pull .env.local

---

Domains & Aliases

vercel domains

Manage domain names.

vercel domains list                          # list domains
vercel domains add <domain> <project>        # add domain
vercel domains inspect <domain>              # show domain info
vercel domains remove <domain>               # remove domain
vercel domains buy <domain>                  # purchase domain
vercel domains transfer-in <domain>          # transfer domain to Vercel

vercel alias

Manage deployment aliases.

vercel alias list                                    # list aliases
vercel alias set <deployment> <alias>                # create alias
vercel alias remove <alias>                          # remove alias

Examples:

vercel alias set my-app-abc123.vercel.app my-app.vercel.app
vercel alias set my-app-abc123.vercel.app custom-domain.com

---

Deployments

vercel ls [app] / vercel list

List deployments.

vercel ls
vercel ls my-project

vercel inspect [id]

Display deployment information.

vercel inspect <deployment-url-or-id>

vercel logs

View runtime logs for a deployment.

Options:

• -j, --json - Output as JSON (compatible with jq)

Examples:

vercel logs my-app.vercel.app
vercel logs <deployment-id> --json
vercel logs <deployment-id> --json | jq 'select(.level == "error")'

vercel promote

Promote deployment to production.

vercel promote <deployment-url-or-id>

vercel rollback [url|id]

Rollback to previous deployment.

vercel rollback
vercel rollback <deployment-url-or-id>

vercel redeploy [url|id]

Rebuild and deploy a previous deployment.

vercel redeploy <deployment-url-or-id>

vercel rm / vercel remove

Remove a deployment.

vercel rm <deployment-url-or-id>

---

Authentication & Teams

vercel login [email]      # log in or create account
vercel logout             # log out
vercel whoami             # show current user
vercel switch [scope]     # switch between scopes/teams
vercel teams              # manage teams

---

Other Commands

vercel open               # open project in dashboard
vercel init [example]     # initialize from example
vercel install [name]     # install marketplace integration
vercel integration        # manage integrations
vercel certs              # manage SSL certificates
vercel dns                # manage DNS records
vercel bisect             # binary search for bug-introducing deployment

---

Global Options

Available on all commands:

Option

Description

-h, --help	Show help
-v, --version	Show version
-d, --debug	Debug mode
-t, --token	Auth token
-S, --scope	Set scope/team
--cwd	Working directory
-A, --local-config	Path to vercel.json
--no-color	Disable colors

---

Quick Reference

Task

Command

Deploy	vercel or vercel --prod
Dev server	vercel dev
Link project	vercel link
List deployments	vercel ls
View logs	vercel logs
Add env var	vercel env add
Pull env vars	vercel env pull
Rollback	vercel rollback
Add domain	vercel domains add
Get docs	curl -s "" -H 'accept: text/markdown'
Docs sitemap	curl -s "" -H 'accept: text/markdown'