Skip to main content
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

Example

Required Flags

—image_ref string

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

Optional Flags

—site string

Which site to optimize on. Leave blank for Namespace to decide.
Last modified on August 20, 2026