Manage Vercel Container Registry with Vercel CLI

You can now manage Vercel Container Registry with Vercel CLI. The new vercel vcr command group lets you:

• Connect your existing container tooling

• Build and push images in one step

• Create and inspect repositories, images, and tags

Authenticate your container tooling, such as Docker, Podman, or Buildah, with a short-lived token scoped to your project. Then build and push:

# Authenticate Docker with the registry
vercel vcr login docker

# Build the current directory and push it in one step
vercel vcr build docker --push

# Build and push with a repository and tag
vercel vcr build docker ./app my-api:1.2.3 --push

The credentials go to Docker itself, so your existing tooling can push to VCR with standard commands:

docker push vcr.vercel.com/my-team/my-project/my-repository:latest

Repositories are created automatically the first time you push, or explicitly with vercel vcr add. From there, you can list what's stored and inspect individual images and tags:

# Create and list repositories
vercel vcr add my-repository
vercel vcr ls

# List images in a repository, or only untagged ones
vercel vcr image ls my-repository
vercel vcr image ls my-repository --untagged

# Inspect a tag
vercel vcr tag inspect my-repository latest

Update to the latest Vercel CLI with pnpm i -g vercel@latest and read the Container Registry docs to get started.

Kevin Corbett