containers-storage-create-container(1)

containers-storage-create-container1

Create a container

Usage

containers-storage create-container [options ...] imageNameOrID

Overview

Creates a container, using the specified image as the starting point for its root filesystem.

Options

-n | --name name

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

-i | --id ID

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

-m | --metadata metadata-value

Sets the metadata for the container to the specified value.

-f | --metadata-file metadata-file

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

Examples

containers-storage create-container -f manifest.json -n new-container goodimage

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.