.nh
.TH "apptainer" "1" "Apr 2024" "Auto generated by spf13/cobra" ""

.SH NAME
.PP
apptainer-key-newpair - Create a new key pair


.SH SYNOPSIS
.PP
\fBapptainer key newpair\fP


.SH DESCRIPTION
.PP
The 'key newpair' command allows you to create a new key or public/private
  keys to be stored in the default user local keyring location (e.g.,
  $HOME/.apptainer/keys).


.SH OPTIONS
.PP
\fB-b\fP, \fB--bit-length\fP=4096
	specify key bit length

.PP
\fB-C\fP, \fB--comment\fP=""
	key comment

.PP
\fB-E\fP, \fB--email\fP=""
	key owner email

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

.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-N\fP, \fB--name\fP=""
	key owner name

.PP
\fB-P\fP, \fB--password\fP=""
	key password

.PP
\fB-U\fP, \fB--push\fP[=false]
	specify to push the public key to the remote keystore


.SH EXAMPLE
.EX

  $ apptainer key newpair
  $ apptainer key newpair --password=psk --name=your-name --comment="key comment" --email=mail@email.com --push=false

.EE


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


.SH HISTORY
.PP
1-Apr-2024 Auto generated by spf13/cobra