DOCKER(1) Docker User Manuals DOCKER(1)

# [NAME](#NAME)

docker-ps - List containers

# [SYNOPSIS](#SYNOPSIS)

**docker ps \[OPTIONS]**

# [DESCRIPTION](#DESCRIPTION)

Alias for **docker container ls**.

# [OPTIONS](#OPTIONS)

**-a**, **--all**\[=false] Show all containers (default shows just running)

**-f**, **--filter**= Filter output based on conditions provided

**--format**="" Format output using a custom template: 'table': Print output in table format with column headers (default) 'table TEMPLATE': Print output in table format using the given Go template 'json': Print in JSON format 'TEMPLATE': Print output using the given Go template. Refer to https://docs.docker.com/go/formatting/ for more information about formatting output with templates

**-n**, **--last**=-1 Show n last created containers (includes all states)

**-l**, **--latest**\[=false] Show the latest created container (includes all states)

**--no-trunc**\[=false] Don't truncate output

**-q**, **--quiet**\[=false] Only display container IDs

**-s**, **--size**\[=false] Display total file sizes

# [SEE ALSO](#SEE_ALSO)

[**docker(1)**](/man/enterprise-packages/docker-cli-fips/docker.1)

Oct 2026 Docker Community

---

Document: docker-ps(1) from docker-cli-fips 29.9.1-r0 (Chainguard OS)
Source: https://github.com/docker/cli