---
name: "oci-image-tool-create"
section: "1"
platform: "linux"
package: "oci-image-tool"
version: "1.0.0~rc2+really.rc1+dfsg-2+b23"
release: "Debian 13 (Trixie)"
platforms: ["linux"]
url: "https://new.carta.tech/oci-image-tool-create"
---

# oci-image-tool-create(1)

Create an OCI runtime bundle

OCI Community JULY 2016

## NAME

oci-image-tool create - Create an OCI runtime bundle

## SYNOPSIS

**oci-image-tool create** \[src\] \[dest\] \[OPTIONS\]

## DESCRIPTION

**oci-image-tool create** validates an application/vnd.oci.image.manifest.v1+json and unpacks its layered filesystem to **dest/rootfs**, although the target directory is configurable with **--rootfs**. See **oci-image-tool unpack**(1) for more details on this process.

Also translates the referenced config from application/vnd.oci.image.config.v1+json to a runtime-spec-compatible **dest/config.json**.

## OPTIONS

**--help**\
   Print usage statement

**--ref**=\[\]\
   Specify the search criteria for the validated reference, format is A=B.\
   Reference should point to a manifest or index.\
   e.g. --ref name=v1.0 --ref platform.os=latest\
   Only support **name**, **platform.os** and **digest** three cases.

**--rootfs**=""\
   A directory representing the root filesystem of the container in the OCI runtime bundle. It is strongly recommended to keep the default value. (default "rootfs")

**--type**=""\
   Type of the file to unpack. If unset, oci-image-tool will try to auto-detect the type. One of "imageLayout,image,imageZip"

**--platform**=""\
   Specify the os and architecture of the manifest, format is OS:Architecture.\
   e.g. --platform linux:amd64\
   Only applicable if reftype is index.

## EXAMPLES

```
$ skopeo copy docker://busybox oci:busybox-oci:latest
$ mkdir busybox-bundle
$ oci-image-tool create --ref name=latest busybox-oci busybox-bundle
$ cd busybox-bundle && sudo runc run busybox
[...]
```

## SEE ALSO

**runc**(1), [**skopeo**(1)](/skopeo/1.md)

## HISTORY

Sept 2016, Originally compiled by Antonio Murdaca (runcom at redhat dot com)