nsc base-image optimize - Namespace Documentation

Optimize a base image so Namespace can boot instances from it quickly. base-image optimize converts an image that already lives in nscr.io into an optimized variant. You only need to optimize a given image digest once. The command blocks until the optimized variant is ready.

Usage

nsc base-image optimize --image_ref <repo>@sha256:<digest> [--push_tag <tag>] [--site <site>]

Example

nsc base-image optimize \
  --image_ref nscr.io/8enum0hp1l5ii/my-worker@sha256:6726e6afa50ad90112c7bd1082eb879cc5d1c87574d70e177813d0ca75617e56

Required Flags

—image_ref string

The image reference to optimize. Pin it to an immutable digest (<repo>@sha256:<digest>).

Optional Flags

—push_tag string

Publish this tag in the source image’s repository after optimization succeeds. The tag points to the source image digest that was optimized.

—site string

Which site to optimize on. Leave blank for Namespace to decide.

nsc base-image upload - Convert an existing image into a base image and upload it to nscr.io
nsc build - Build container images using Namespace Remote Builders
Bazel Remote Execution - Use custom worker images with RBE

Last modified on October 26, 2026

⌘I