> ## 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, macOS, and Windows Devbox base images, including built-in images. By default, only the latest Linux image in each repository is shown.

## Usage

```bash theme={"theme":{"light":"github-light-default","dark":"github-dark-default"}}
devbox image list [flags]
```

## Examples

### List the latest available images

```bash theme={"theme":{"light":"github-light-default","dark":"github-dark-default"}}
devbox image list
```

### List Windows images

```bash theme={"theme":{"light":"github-light-default","dark":"github-dark-default"}}
devbox image list --platform windows
```

### List all Linux image versions as JSON

```bash theme={"theme":{"light":"github-light-default","dark":"github-dark-default"}}
devbox image list --platform linux/amd64 --all_images --output json
```

## Options

**--all\_images** `boolean` (default: false)

Show every Linux image version instead of only the latest version in each repository.

**-o, --output** `string`

Set the output format to `json` or `table`. When omitted, the CLI renders a table.

**--platform** `strings`

Limit results to `linux`, `linux/amd64`, `macos`, `macos/arm64`, `windows`, or `windows/amd64`. `--machine_type` is an alias. Repeat the option to select multiple platforms.

## Related topics

> [card] [Custom images](https://namespace.so/docs/devbox/images.md)
>
> Build and manage custom images.

> [card] [devbox image describe](https://namespace.so/docs/reference/devbox-cli/image-describe.md)
>
> Display full JSON details for an image.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.