# Vercel Container Registry now supports 2 GB compressed image layers

By Steven Van · 2026-10-28

Layers in Vercel's registry can now reach 2 GB compressed, up from 500 MB, while the total image limit stays at 15 GB.

The [Vercel](<https://creatorstoolbox.com/tools/vercel>) Container Registry now accepts compressed image layers of up to 2 GB, up from 500 MB. Larger layers can be pushed without splitting them. The total image size limit stays at 15 GB, according to the [getting-started guide](<https://vercel.com/docs/container-registry/getting-started>).

## Where the higher limit helps

Vercel says the change is useful for images with large toolchains or dependency sets. Its example is custom Vercel Sandbox environments for coding-agent evaluations.

## Pushing an image

With Docker and the Vercel CLI installed, run these commands from the directory containing your Dockerfile:

- **vercel link** links the project, since every repository belongs to a Vercel project.

- **vercel vcr login docker** authenticates Docker with a short-lived, project-scoped OIDC token that is valid for 12 hours.

- **vercel vcr build docker . --push** builds the current directory and pushes the image.

No repository needs to be created first. The registry creates one named after the project on the first push. A different repository name or tag can be passed as *name\[:tag\]*.

## Pulling an image

Run *vercel vcr tag inspect project-name latest* to print the full image reference, then pull that reference with Docker, Podman or Buildah.

![Vercel](<https://www.google.com/s2/favicons?domain=vercel.com&sz=128>)

Vercel

The platform for frontend developers — deploy, preview, and scale web apps and AI agents with zero config.

[View Vercel →](<https://creatorstoolbox.com/tools/vercel>)

Sources

[Original source](<https://vercel.com/changelog/vercel-container-registry-now-supports-2-gb-compressed-image-layers-new>)

[Read Vercel Container Registry now supports 2 GB compressed image layers on Creators Toolbox](<https://creatorstoolbox.com/blog/vercel-vercel-container-registry-now-supports-2-gb-compressed-image-layers>)

---
Canonical source: https://creatorstoolbox.com/blog/vercel-vercel-container-registry-now-supports-2-gb-compressed-image-layers
