Skip to content

vercel vcr

The vercel vcr command is the entry point for managing Vercel Container Registry (VCR) from the Vercel CLI. It groups subcommands for building and pushing images, for listing, inspecting, creating, and deleting repositories, for managing their tags and images, and for sharing repositories with other teams. The full command surface is documented in the Container Registry CLI Reference. This page summarizes the entry point and links to the full reference.

terminal
vercel vcr [subcommand]

Using vercel vcr to manage Vercel Container Registry from the terminal.

terminal
vercel vcr ls
List the container registry repositories in the linked project.
terminal
vercel vcr login docker

Authenticate Docker with the Vercel Container Registry using a short-lived OIDC token.

terminal
vercel vcr build docker . --push

Build the current directory with Docker and push it to the linked project's repository.

For the full list of subcommands, options, and examples, see the Container Registry CLI Reference. Use vercel vcr login to authenticate Docker, Podman, or Buildah with VCR, vercel vcr build and vercel vcr push to publish images, vercel vcr tag to browse a repository's tags, vercel vcr image to list, inspect, or delete images, and vercel vcr permissions to manage which teams a repository is shared with. For the end-to-end workflow, see the Container Registry documentation.

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

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

Last updated August 13, 2026

Was this helpful?