---
name: "containers-storage-create-image"
section: "1"
platform: "linux"
package: "containers-common"
version: "1:0.69.2-1"
release: "Arch Linux 2026-11-01"
platforms: ["linux"]
url: "https://new.carta.tech/containers-storage-create-image"
---

# containers-storage-create-image(1)

Create an image

## NAME

containers-storage-create-image - Create an image

## SYNOPSIS

**containers-storage** **create-image** \[*options*...\] *topLayerNameOrID*

## DESCRIPTION

Creates an image, referring to the specified layer as the one which should be used as the basis for containers which will be based on the image.

## OPTIONS

**-n \| --name** *name*

Sets an optional name for the image.  If a name is already in use, an error is returned.

**-i \| --id** *ID*

Sets the ID for the image.  If none is specified, one is generated.

**-m \| --metadata** *metadata-value*

Sets the metadata for the image to the specified value.

**-f \| --metadata-file** *metadata-file*

Sets the metadata for the image to the contents of the specified file.

## EXAMPLE

```
containers-storage create-image -f manifest.json -n new-image somelayer
```

## SEE ALSO

[containers-storage-create-container(1)](/containers-storage-create-container/1.md) [containers-storage-create-layer(1)](/containers-storage-create-layer/1.md) [containers-storage-delete-image(1)](/containers-storage-delete-image/1.md)