Skip to main content
Optimize a registered Linux base image for a Namespace site. Without --name or --site, the CLI prompts you to select the missing values.

Usage

Examples

Optimize an image for a site

Options

boolean
default:"false"
Include every image version in the interactive picker instead of only the latest version in each repository.
string
Optimize an image repository directly and skip interactive image selection. If multiple versions exist, the newest matching image is selected.
string
Set the target site, such as ord, iad, or zrh, and skip interactive site selection.

devbox image list

Find available image names.

devbox image build

Build and optimize an image in one command.

Custom images

Learn how image optimization fits the image workflow.
Last modified on August 28, 2026