containers-storage-create-image(1)

containers-storage-create-image1

Create an image

Usage

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

Overview

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.

Examples

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

Releases

4 releases since Debian 11 (Bullseye); the text changed 2 times.

  1. 11
  2. 12–13
  3. Arch

From containers-common 1:0.69.2-1 in Arch Linux 2026-11-01. Parsed by carta from the page's man source.