> ## 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 list

> List available Devbox base images.

List available Linux and macOS Devbox base images, including built-in images. By default, only the latest Linux image in each repository is shown.

## Usage

```bash theme={null}
devbox image list [flags]
```

## Examples

### List the latest available images

```bash theme={null}
devbox image list
```

### List all Linux image versions as JSON

```bash theme={null}
devbox image list --platform linux/amd64 --all_images --output json
```

## Options

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

<ResponseField name="-o, --output" type="string">
  Set the output format to `json` or `table`. When omitted, the CLI renders a table.
</ResponseField>

<ResponseField name="--platform" type="strings">
  Limit results to `linux`, `linux/amd64`, `macos`, or `macos/arm64`. `--machine_type` is an alias. Repeat the option to select multiple platforms.
</ResponseField>

## Related topics

<Columns cols={2}>
  <Card title="Custom images" icon="hard-drive" href="/docs/devbox/images">
    Build and manage custom images.
  </Card>

  <Card title="devbox image describe" icon="file-search" href="/docs/reference/devbox-cli/image-describe">
    Display full JSON details for an image.
  </Card>
</Columns>