---
name: "singularity-oci-create"
section: "1"
platform: "linux"
package: "apptainer"
version: "1.5.4-1"
release: "Arch Linux 2026-11-01"
platforms: ["linux"]
url: "https://new.carta.tech/singularity-oci-create"
---

# singularity-oci-create(1)

Create a container from a bundle directory (root user only)

## NAME

apptainer-oci-create - Create a container from a bundle directory (root user only)

## SYNOPSIS

**apptainer oci create -b  \[create options...\]**

## DESCRIPTION

Create invoke create operation to create a container instance from an OCI\
   bundle directory

## OPTIONS

**-b**, **--bundle**=""\
 	specify the OCI bundle path (required)

**--empty-process**\[=false\]\
 	run container without executing container process (eg: for POD container)

**-h**, **--help**\[=false\]\
 	help for create

**--log-format**="kubernetes"\
 	specify the log file format. Available formats are basic, kubernetes and json

**-l**, **--log-path**=""\
 	specify the log file path

**--pid-file**=""\
 	specify the pid file

**-s**, **--sync-socket**=""\
 	specify the path to unix socket for state synchronization

## EXAMPLE

```
  $ apptainer oci create -b ~/bundle mycontainer
```

## SEE ALSO

**[apptainer-oci(1)](/apptainer-oci/1.md)**

## HISTORY

22-Sep-2026 Auto generated by spf13/cobra
