Skip to main content
Expire a registered Linux base image so it cannot be used to create new Devboxes. Existing Devboxes created from the image are not affected. Pass a repository to expire its image, or pass both a repository and digest to target an exact version. With no arguments, the CLI opens an interactive picker.

​
Usage

​
Examples

​
Expire an image repository

Output

​
Expire an exact image version

​
Options

​
boolean
default:"false"
Include every image version in the interactive picker instead of only the latest version in each repository.

Custom images

Understand image expiration and its effect on existing Devboxes.

devbox image list

Find image repositories and versions.

devbox image describe

Inspect an image before expiring it.
Last modified on August 28, 2026