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

# guild container-image

> Register and manage container images.

Manage container images. An image is identified by its owner and name, both passed as flags — these commands take no positional arguments.

```bash theme={null}
guild container-image list                                    # List container images
guild container-image get --owner acme --name base            # Show one image
guild container-image create --owner acme --name base \
  --image us-docker.pkg.dev/project/repo/image --tag latest   # Register an image
guild container-image modify --owner acme --name base --tag v2  # Change the tag
```

## list

| Option              | Description                                                                |
| ------------------- | -------------------------------------------------------------------------- |
| `--owner <name>`    | Account name or ID to list images for. Defaults to the authenticated user. |
| `--limit <number>`  | Number of results to return (default: 20).                                 |
| `--offset <number>` | Offset for pagination (default: 0).                                        |

## get

Shows an image, including its setup script. `--owner` and `--name` are both required.

## create

`--owner`, `--name`, `--image`, and `--tag` are all required.

| Option            | Description                                                                              |
| ----------------- | ---------------------------------------------------------------------------------------- |
| `--owner <name>`  | Owner account name or ID.                                                                |
| `--name <name>`   | Image name. Lowercase letters, digits, hyphens, dots, and underscores; 1–100 characters. |
| `--image <image>` | Docker image path, without a tag — for example `us-docker.pkg.dev/project/repo/image`.   |
| `--tag <tag>`     | Docker tag, for example `latest`.                                                        |

## modify

`--owner` and `--name` identify the image; pass at least one of the remaining options.

| Option            | Description                                                      |
| ----------------- | ---------------------------------------------------------------- |
| `--image <image>` | New Docker image path.                                           |
| `--tag <tag>`     | New Docker tag.                                                  |
| `--public`        | Make the image public. **One-way door** — this cannot be undone. |
| `--yes`           | Skip the confirmation prompt for `--public`.                     |