> ## Documentation Index
> Fetch the complete documentation index at: https://namespace.so/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# devbox image expire

> Expire a Devbox base image.

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

```bash theme={null}
devbox image expire [repository] [digest] [flags]
```

## Examples

### Expire an image repository

```bash theme={null}
devbox image expire my-team/golang
```

```text Output nocopy theme={null}
done.
```

### Expire an exact image version

```bash theme={null}
devbox image expire my-team/golang sha256:<digest>
```

## Options

<ResponseField name="--all_images" type="boolean" default="false">
  Include every image version in the interactive picker instead of only the latest version in each repository.
</ResponseField>

## Related topics

<Columns cols={3}>
  <Card title="Custom images" icon="hard-drive" href="/docs/devbox/images">
    Understand image expiration and its effect on existing Devboxes.
  </Card>

  <Card title="devbox image list" icon="list" href="/docs/reference/devbox-cli/image-list">
    Find image repositories and versions.
  </Card>

  <Card title="devbox image describe" icon="file-search" href="/docs/reference/devbox-cli/image-describe">
    Inspect an image before expiring it.
  </Card>
</Columns>