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

# apptainer-oci-run(1)

Create/start/attach/delete a container from a bundle directory (root user only)

## NAME

apptainer-oci-run - Create/start/attach/delete a container from a bundle directory (root user only)

## SYNOPSIS

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

## DESCRIPTION

Run will invoke equivalent of create/start/attach/delete commands in a row.

## OPTIONS

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

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

**--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 run -b ~/bundle mycontainer
  is equivalent to :
  $ apptainer oci create -b ~/bundle mycontainer
  $ apptainer oci start mycontainer
  $ apptainer oci attach mycontainer
  $ apptainer oci delete mycontainer
```

## SEE ALSO

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

## HISTORY

22-Sep-2026 Auto generated by spf13/cobra