.nh
.TH "apptainer" "1" "Jan 2026" "Auto generated by spf13/cobra" ""

.SH NAME
apptainer-key-list - List keys in your local or in the global keyring


.SH SYNOPSIS
\fBapptainer key list\fP


.SH DESCRIPTION
List your local keys in your keyring. Will list public (trusted) keys
  by default.


.SH OPTIONS
\fB-g\fP, \fB--global\fP[=false]
	manage global public keys (import/pull/remove are restricted to root user or unprivileged installation only)

.PP
\fB-h\fP, \fB--help\fP[=false]
	help for list

.PP
\fB-d\fP, \fB--keysdir\fP="/build/.apptainer/keys"
	set local keyring dir path, an alternative way is to set environment variable 'APPTAINER_KEYSDIR'

.PP
\fB-s\fP, \fB--secret\fP[=false]
	list private keys instead of the default which displays public ones


.SH EXAMPLE
.EX

  $ apptainer key list
  $ apptainer key list --secret

  # list global public keys
  $ apptainer key list --global
.EE


.SH SEE ALSO
\fBapptainer-key(1)\fP


.SH HISTORY
8-Jan-2026 Auto generated by spf13/cobra