runc-list(8) System Manager's Manual runc-list(8)

# [NAME](#NAME)

**runc-list** - lists containers

# [SYNOPSIS](#SYNOPSIS)

**runc list** \[*option* ...]

# [DESCRIPTION](#DESCRIPTION)

The **list** commands lists containers. Note that a global **--root** option can be specified to change the default root. For the description of **--root**, see [**runc**(8)](/man/os/runc-1.4/runc.8).

# [OPTIONS](#OPTIONS)

[**--format**|**-f** **table**|**json**](#format)

Specify the format. Default is **table**. The **json** format provides more details.

[**--quiet**|**-q**](#quiet)

Only display container IDs.

# [EXAMPLES](#EXAMPLES)

To list containers created with the default root:

```
# runc list
```

To list containers in a human-readable JSON (with the help of [**jq**(1)](/man/os/runc-1.4/jq.1) utility):

```
# runc list -f json | jq
```

To list containers created with the root of **/tmp/myroot**:

```
# runc --root /tmp/myroot
```

# [SEE ALSO](#SEE_ALSO)

[**runc**(8)](/man/os/runc-1.4/runc.8).

---

Document: runc-list(8) from runc-1.4 1.4.3-r11 (Chainguard OS)
Source: https://github.com/opencontainers/runc