podman-secret-ls(1)

podman-secret-ls1

List all available secrets

Usage

podman secret ls [options]

Overview

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

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:

FilterDescription
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:

PlaceholderDescription
.CreatedAtWhen secret was created (relative timestamp, human-readable)
.DriverDriver name (string)
.IDID of secret
.NameName of secret
.UpdatedAtWhen secret was last updated (relative timestamp, human-readable)

--noheading, -n

Omit the table headings from the listing.

--quiet, -q

Print secret IDs only.

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

Releases

3 releases since Debian 12 (Bookworm); the text changed 2 times.

  1. 12
  2. 13
  3. Arch

History

January 2021, Originally compiled by Ashley Cui [email protected] ⟨mailto:[email protected]⟩

From podman 6.1.4-1 in Arch Linux 2026-11-01. Parsed by carta from the page's man source.