# Manage Vercel Container Registry with Vercel CLI

**Published:** August 20, 2026 | **Authors:** Marc Codina Segura, Andy Waller | **Contributors:** Kevin Corbett

---

You can now manage [Vercel Container Registry](https://vercel.com/docs/container-registry) with [Vercel CLI](https://vercel.com/docs/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:

```bash
# 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:

```bash
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:

```bash
# 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](https://vercel.com/docs/container-registry) to get started.

---

📚 **More updates:** [View all changelog entries](/changelog/sitemap.md) | [Blog](/blog/sitemap.md)