---
name: "buildah-manifest"
section: "1"
platform: "linux"
package: "buildah"
version: "1:1.45.2-1"
release: "Arch Linux 2026-11-01"
platforms: ["linux"]
url: "https://new.carta.tech/buildah-manifest"
---

# buildah-manifest(1)

Create and manipulate manifest lists and image indexes.

## NAME

buildah-manifest - Create and manipulate manifest lists and image indexes.

## SYNOPSIS

buildah manifest COMMAND \[OPTIONS\] \[ARG...\]

## DESCRIPTION

The **buildah manifest** command provides subcommands which can be used to:

```
* Create a working Docker manifest list or OCI image index.
* Add an entry to a manifest list or image index for a specified image.
* Add an entry to an image index for an artifact manifest referring to a file.
* Add or update information about an entry in a manifest list or image index.
* Delete a working container or an image.
* Push a manifest list or image index to a registry or other location.
```

## SUBCOMMANDS

| | | |
| --- | --- | --- |
| **Command** | **Man Page** | **Description** |
| add | [buildah-manifest-add(1)](/buildah-manifest-add/1.md) | Add an image or artifact to a manifest list or image index. |
| annotate | [buildah-manifest-annotate(1)](/buildah-manifest-annotate/1.md) | Add or update information about an image or artifact in a manifest list or image index. |
| create | [buildah-manifest-create(1)](/buildah-manifest-create/1.md) | Create a manifest list or image index. |
| exists | [buildah-manifest-exists(1)](/buildah-manifest-exists/1.md) | Check if a manifest list exists in local storage. |
| inspect | [buildah-manifest-inspect(1)](/buildah-manifest-inspect/1.md) | Display the contents of a manifest list or image index. |
| push | [buildah-manifest-push(1)](/buildah-manifest-push/1.md) | Push a manifest list or image index to a registry or other location. |
| remove | [buildah-manifest-remove(1)](/buildah-manifest-remove/1.md) | Remove an image from a manifest list or image index. |
| rm | [buildah-manifest-rm(1)](/buildah-manifest-rm/1.md) | Remove manifest list from local storage. |

## EXAMPLES

### Building a multi-arch manifest list from a Containerfile

Assuming the **Containerfile** uses **RUN** instructions, the host needs a way to execute non-native binaries.  Configuring this is beyond the scope of this example.  Building a multi-arch manifest list **shazam** in parallel across 4-threads can be done like this:

```
    $ platarch=linux/amd64,linux/ppc64le,linux/arm64,linux/s390x
    $ buildah build --jobs=4 --platform=$platarch --manifest shazam .
```

**Note:** The **--jobs** argument is optional, and the **--manifest** option should be used instead of the**-t** or **--tag** options.

### Assembling a multi-arch manifest from separately built images

Assuming **example.com/example/shazam:$arch** images are built separately on other hosts and pushed to the **example.com** registry.  They may be combined into a manifest list, and pushed using a simple loop:

```
    $ REPO=example.com/example/shazam
    $ buildah manifest create $REPO:latest
    $ for IMGTAG in amd64 s390x ppc64le arm64; do
              buildah manifest add $REPO:latest docker://$REPO:IMGTAG;
          done
    $ buildah manifest push --all $REPO:latest
```

**Note:** The **add** instruction argument order is **\<manifest\>** then **\<image\>**. Also, the **--all** push option is required to ensure all contents are pushed, not just the native platform/arch.

### Removing and tagging a manifest list before pushing

Special care is needed when removing and pushing manifest lists, as opposed to the contents.  You almost always want to use the **manifest rm** and **manifest push --all** subcommands.  For example, a rename and push could be performed like this:

```
    $ buildah tag localhost/shazam example.com/example/shazam
    $ buildah manifest rm localhost/shazam
    $ buildah manifest push --all example.com/example/shazam
```

## SEE ALSO

[buildah(1)](/buildah/1.md), [buildah-manifest-create(1)](/buildah-manifest-create/1.md), [buildah-manifest-add(1)](/buildah-manifest-add/1.md), [buildah-manifest-remove(1)](/buildah-manifest-remove/1.md), [buildah-manifest-annotate(1)](/buildah-manifest-annotate/1.md), [buildah-manifest-inspect(1)](/buildah-manifest-inspect/1.md), [buildah-manifest-push(1)](/buildah-manifest-push/1.md), [buildah-manifest-rm(1)](/buildah-manifest-rm/1.md)