@vercel/container
27.0.0 · 18 Nov 2026Apache-2.03.8M / weekRepositoryHomepagenpmAtom feed
0.2.0 is the newest release of 0.0.x.
In short
1 new2 fixed
Release note
Patch Changes
vc devno longer leaks host/shell-only environment variables into container
services. Variables that describe the developer's machine rather than the Linux
container — notably macOSTMPDIR(/var/folders/.../T), plusHOME,PATH,SHELL, and similar — are now filtered out of the container's env. Previously
they were passed through and broke apps that write to the OS temp dir (e.g.
Ghost's multer upload middleware failed withEACCES). The container's own
values for these are used instead.vc devnow publishes container services on the host port the services
orchestrator pre-allocated (meta.port) instead of a Docker-chosen ephemeral
port. Service bindings target the pre-allocated port
(http://127.0.0.1:<port>/), so a container published on a different port was
unreachable for cross-service requests. Falls back to an ephemeral port when no
port is provided.Add an experimental container service runtime. A service with
runtime: "container"either builds itsDockerfile/Containerfileand pushes
the resulting OCI image to the Vercel Container Registry (VCR), or passes a
prebuilt image reference through as build output.@vercel/container(new builder): authenticates to VCR with the project'sVERCEL_OIDC_TOKEN, ensures the repository exists, builds and pushes the
image, and emits a digest-pinned reference inhandler(container functions
aretype: "Lambda"withruntime: "container"; the platform surfaceshandleras the image downstream). Usesdockeron developer machines andbuildah(daemonless) in the Vercel build container behind a sharedContainerEngineinterface. Supportsvc devviastartDevServer(local
build/run, env parity, log forwarding) andprepareCachefor buildah layer
reuse between builds. Build flow is instrumented with tracing spans
(non-secret diagnostics) and debug logging gated onBUILDER_DEBUG.@vercel/build-utils: add theContainerImagebuild-output type.@vercel/fs-detectors: resolve container services fromvercel.json
(theservicesconfig and its deprecatedexperimentalServices/experimentalServicesV2aliases). ADockerfile,Containerfile, or*.dockerfileentrypoint triggers a build; any other entrypoint is treated as
a prebuilt OCI image reference.vercel: wire container output intovercel buildresult writing and
config validation.
Buildah specifics in the build container: host networking for
RUNsteps,
nativeoverlaystorage on the XFS/vercelvolume (deferring to the image'sstorage.conf), zstd push compression, and registry credentials read from the
provisioned auth file when present. Several knobs are available for debugging:VERCEL_CONTAINER_ENGINE,VERCEL_VCR_STRICT_STORAGE,VERCEL_VCR_DISABLE_LAYER_CACHE, andVERCEL_VCR_FORCE_LOGIN.
A whole project to check? Paste its package.json in the dependency check: every deprecated, outdated or vulnerable dependency, with what to upgrade to. Free, no account.