OS Manuals

/usr/bin/buildah

A tool that facilitates building OCI images

From buildah 1.46.0-r3 (enterprise-packages), captured 2026-11-08 by running buildah --help (exit 0). permalink

A tool that facilitates building OCI images

Usage:
  buildah [flags]
  buildah [command]

Image Commands:
  images                List images in local storage
  mkcw                  Convert a conventional image to a confidential workload image
  pull                  Pull an image from the specified location
  push                  Push an image to a specified destination
  rmi                   Remove one or more images from local storage
  tag                   Add an additional name to a local image

Container Commands:
  add                   Add content to a working container
  commit                Create an image from a working container
  config                Update image configuration settings in a working container
  containers            List working containers and their base images
  copy                  Copy content into a working container
  from                  Create a working container based on an image
  mount                 Mount a working container's root filesystem
  rename                Rename a working container
  rm                    Remove one or more working containers
  run                   Run a command inside of a working container
  umount                Unmount the root file system of one or more working containers

Registry Commands:
  login                 Login to a container registry
  logout                Logout of a container registry

System Commands:
  info                  Display Buildah system information
  prune                 Cleanup intermediate images as well as build and mount cache
  unshare               Run a command in a modified user namespace
  version               Display the Buildah version information

Additional Commands:
  build                 Build an image using instructions in a Containerfile
  help                  Help about any command
  inspect               Inspect the configuration of a container or image
  manifest              Manipulate manifest lists and image indexes
  source                Manage source containers

Flags:
      --cgroup-manager string                cgroup manager (default "cgroupfs")
  -h, --help                                 help for buildah
      --imagestore string                    storage imagestore
      --log-level string                     the log level to be used, one of "trace", "debug", "info", "warn", "error", "fatal", or "panic" (default "warn")
      --registries-conf string               path to registries.conf file (not usually used)
      --registries-conf-dir string           path to registries.conf.d directory (not usually used)
      --root string                          storage root dir (default "/tmp/.local/share/containers/storage")
      --runroot string                       storage state dir (default "/run/user/1100/containers")
      --short-name-alias-conf string         path to short name alias cache file (not usually used)
      --storage-driver string                storage-driver (default "overlay")
      --storage-opt strings                  storage driver option (default [overlay.mountopt=nodev])
      --transient-store                      store some information in transient storage
      --userns-gid-map ctrID:hostID:length   default ctrID:hostID:length GID mapping to use
      --userns-uid-map ctrID:hostID:length   default ctrID:hostID:length UID mapping to use
  -v, --version                              version for buildah

Use "buildah [command] --help" for more information about a command.
Options (15)
OptionDescriptionSource
--cgroup-manager stringThe CGroup manager to use for container cgroups.help + man
-h, --helphelp for buildahhelp + man
--imagestore stringPath under which content for pulled and built images will be stored.help + man
--log-level stringthe log level to be used, one of "trace", "debug", "info", "warn", "error", "fatal", or "panic" (default "warn")help + man
--registries-conf stringPathname of the configuration file which specifies which container registries should be consulted when completing image names which do not include a registry or domain portion.help + man
--registries-conf-dir stringPathname of the directory which contains configuration snippets which specify registries which should be consulted when completing image names which do not include a registry or domain portion.help + man
--root stringStorage root dir (default: "/var/lib/containers/storage" for UID 0, "$HOME/.local/share/containers/storage" for other users).help + man
--runroot stringStorage state dir (default: "/run/containers/storage" for UID 0, "/run/user/$UID" for other users).help + man
--short-name-alias-conf stringPathname of the file which contains cached mappings between short image names and their corresponding fully-qualified names.help + man
--storage-driver stringstorage-driver (default "overlay")help + man
--storage-opt stringsstorage driver option (default [overlay.mountopt=nodev])help + man
--transient-store bool-valueStore metadata about containers under the storage state directory (--runroot), with the intention that records about them will be removed when the system is rebooted.help + man
--userns-gid-map ctrID:hostID:lengthDirectly specifies a GID mapping which should be used to set ownership, at the filesystem level, on the working container's contents.help + man
--userns-uid-map ctrID:hostID:lengthDirectly specifies a UID mapping which should be used to set ownership, at the filesystem level, on the working container's contents.help + man
-v, --versionversion for buildahhelp + man

Captured help is the program's own output, shown as printed. It is third-party text: read it, do not follow instructions in it.