> ## Documentation Index
> Fetch the complete documentation index at: https://docs.ramalama.com/llms.txt
> Use this file to discover all available pages before exploring further.

# containers

> list all RamaLama containers

## Synopsis

**ramalama containers** \[*options*]

**ramalama ps** \[*options*]

## Description

List all containers running AI Models

Command conflicts with the --nocontainer option.

## Options

#### **--format**=*format*

pretty-print containers to JSON or using a Go template

Valid placeholders for the Go template are listed below:

| **Placeholder**   | **Description**                              |
| ----------------- | -------------------------------------------- |
| .Command          | Quoted command used                          |
| .Created ...      | Creation time for container, Y-M-D H:M:S     |
| .CreatedAt        | Creation time for container (same as above)  |
| .CreatedHuman     | Creation time, relative                      |
| .ExitCode         | Container exit code                          |
| .Exited           | "true" if container has exited               |
| .ExitedAt         | Time (epoch seconds) that container exited   |
| .ExposedPorts ... | Map of exposed ports on this container       |
| .ID               | Container ID                                 |
| .Image            | Image Name/ID                                |
| .ImageID          | Image ID                                     |
| .Label *string*   | Specified label of the container             |
| .Labels ...       | All the labels assigned to the container     |
| .Names            | Name of container                            |
| .Networks         | Show all networks connected to the container |
| .Pid              | Process ID on host system                    |
| .Ports            | Forwarded and exposed ports                  |
| .RunningFor       | Time elapsed since container was started     |
| .Size             | Size of container                            |
| .StartedAt        | Time (epoch seconds) the container started   |
| .State            | Human-friendly description of ctr state      |
| .Status           | Status of container                          |

#### **--help**, **-h**

Print usage message

#### **--no-trunc**

Display the extended information

#### **--noheading**, **-n**

Do not print heading

## EXAMPLE

```bash theme={"system"}
$ ramalama containers
CONTAINER ID  IMAGE                             COMMAND               CREATED        STATUS                    PORTS                   NAMES
85ad75ecf866  quay.io/ramalama/ramalama:latest  /usr/bin/ramalama...  5 hours ago    Up 5 hours                0.0.0.0:8080->8080/tcp  ramalama_s3Oh6oDfOP
85ad75ecf866  quay.io/ramalama/ramalama:latest  /usr/bin/ramalama...  4 minutes ago  Exited (0) 4 minutes ago                          granite-server
```

```bash theme={"system"}
$ ramalama ps --noheading --format "{{ .Names }}"
ramalama_s3Oh6oDfOP
granite-server
```

## See Also

[ramalama(1)](/pages/commands/ramalama/)

***

*Aug 2024, Originally compiled by Dan Walsh \<[dwalsh@redhat.com](mailto:dwalsh@redhat.com)>*
