podman-secret-ls(1) General Commands Manual podman-secret-ls(1)

# [NAME](#NAME)

podman-secret-ls - List all available secrets

# [SYNOPSIS](#SYNOPSIS)

**podman secret ls** \[*options*]

# [DESCRIPTION](#DESCRIPTION)

Lists all the secrets that exist. The output can be formatted to a Go template using the **--format** option.

# [OPTIONS](#OPTIONS)

## **--filter**, **-f**=*filter=value*

Filter output based on conditions given. Multiple filters can be given with multiple uses of the --filter option.

Valid filters are listed below:

**Filter** **Description** name \[Name] Secret name (accepts regex) id \[ID] Full or partial secret ID

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

Format secret output using Go template.

Valid placeholders for the Go template are listed below:

**Placeholder** **Description** .CreatedAt When secret was created (relative timestamp, human-readable) .Driver Driver name (string) .ID ID of secret .Name Name of secret .UpdatedAt When secret was last updated (relative timestamp, human-readable)

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

Omit the table headings from the listing.

## **--quiet**, **-q**

Print secret IDs only.

# [EXAMPLES](#EXAMPLES)

List all secrets.

```
$ podman secret ls
```

List the name field of all secrets.

```
$ podman secret ls --format "{{.Name}}"
```

List all secrets whose name includes the specified string.

```
$ podman secret ls --filter name=confidential
```

# [SEE ALSO](#SEE_ALSO)

[**podman(1)**](/man/os/podman/podman.1), [**podman-secret(1)**](/man/os/podman/podman-secret.1)

# [HISTORY](#HISTORY)

January 2021, Originally compiled by Ashley Cui acui@redhat.com ⟨mailto:acui@redhat.com⟩

---

Document: podman-secret-ls(1) from podman 6.0.0-r4 (Chainguard OS)