releases.shpreview

OCI container service runtime ships; Northstar scope resolution fixed

vercel@54.16.0

3 features2 enhancements3 fixesThis release3 featuresNew capabilities2 enhancementsImprovements to existing features3 fixesBug fixesAI-tallied from the release notes

Minor Changes

  • 9fb2976: Add services as the canonical multi-service project configuration and keep experimentalServicesV2 as a deprecated backwards-compatible alias.
  • 260b0be: Support the VQS idempotency key header in the local development server.

Patch Changes

  • 6a43bf2: Adding 2 additional headers to Vercel API calls

  • 186014d: Fix vc dev erroring with "Project framework is set to 'services', but no services are declared" for experimentalServicesV2 (services) projects. When the dev server already has resolved services, it now skips zero-config builder detection and lets the services orchestrator build and run them. Previously detectBuilders ran with the remote framework: "services" setting but no service config threaded in, which failed even though detection had succeeded.

  • 186014d: Add an experimental container service runtime. A service with runtime: "container" either builds its Dockerfile/Containerfile and 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's VERCEL_OIDC_TOKEN, ensures the repository exists, builds and pushes the image, and emits a digest-pinned reference in handler (container functions are type: "Lambda" with runtime: "container"; the platform surfaces handler as the image downstream). Uses docker on developer machines and buildah (daemonless) in the Vercel build container behind a shared ContainerEngine interface. Supports vc dev via startDevServer (local build/run, env parity, log forwarding) and prepareCache for buildah layer reuse between builds. Build flow is instrumented with tracing spans (non-secret diagnostics) and debug logging gated on BUILDER_DEBUG.
    • @vercel/build-utils: add the ContainerImage build-output type.
    • @vercel/fs-detectors: resolve container services from vercel.json (the services config and its deprecated experimentalServices / experimentalServicesV2 aliases). A Dockerfile, Containerfile, or *.dockerfile entrypoint triggers a build; any other entrypoint is treated as a prebuilt OCI image reference.
    • vercel: wire container output into vercel build result writing and config validation.

    Buildah specifics in the build container: host networking for RUN steps, native overlay storage on the XFS /vercel volume (deferring to the image's storage.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, and VERCEL_VCR_FORCE_LOGIN.

  • 007af8f: Deduplicate the team billing settings URL into a shared getTeamBillingUrl helper.

  • edb7256: [vc dev] Apply route transforms under vercel dev.

  • 1c5d3b3: Fixed scope resolution for Northstar accounts whose username collides with the slug of their default team.

    • Commands now scope API requests to the Northstar default team on every invocation, not just at login. Previously the default team was resolved for display (vc whoami showing "Active team: my-user") while requests were sent with no teamId, silently scoping to the resource-less personal account. This caused commands like vc projects ls to report "No projects found" even though the team has projects.
    • --scope <name> now resolves against the user's teams before falling back to personal-account handling. A team whose slug matches the user's username (e.g. a Northstar default team) can now be selected by name instead of being rejected with "You cannot set your Personal Account as the scope."
  • ded2d92: Refresh VERCEL_OIDC_TOKEN after vercel link without overwriting other variables or formatting in an existing .env.local file.

  • Updated dependencies [fdb6121]

  • Updated dependencies [9fb2976]

  • Updated dependencies [186014d]

  • Updated dependencies [186014d]

  • Updated dependencies [186014d]

  • Updated dependencies [e6759d0]

  • Updated dependencies [68ed45c]

  • Updated dependencies [cb0988f]

    • @vercel/backends@0.8.17
    • @vercel/build-utils@13.32.0
    • @vercel/container@0.0.1
    • @vercel/go@3.10.0
    • @vercel/next@4.20.0
    • @vercel/elysia@0.1.96
    • @vercel/express@0.1.108
    • @vercel/fastify@0.1.99
    • @vercel/h3@0.1.105
    • @vercel/hono@0.2.99
    • @vercel/hydrogen@1.4.0
    • @vercel/koa@0.1.79
    • @vercel/nestjs@0.2.100
    • @vercel/node@5.8.20
    • @vercel/python@6.47.1
    • @vercel/redwood@2.5.0
    • @vercel/remix-builder@5.9.1
    • @vercel/ruby@2.5.1
    • @vercel/rust@1.3.0
    • @vercel/static-build@2.11.2

Fetched June 24, 2026