apptainer(1)

💅 apptainer — key newpair (apptainer(1))

okay bestie, welcome to the apptainer(1) page ✨ — well, technically the apptainer key newpair corner of it, and honestly? it's kind of a vibe. grab a strawberry 🍓 and let's get into it.

---

🌸 NAME

apptainer-key-newpair — create a new key pair 🔑 (yes, that's the whole personality)

---

🦋 SYNOPSIS

apptainer key newpair

that's it. that's the whole call. lowkey iconic for how much it does with so little 💅

---

🎀 DESCRIPTION

so the key newpair command is literally your little key-making bestie 🫶 — it lets you create a brand-new key, or public/private keys, and it tucks them away in your default user local keyring location. like, the default spot, no cap. for example:

$HOME/.apptainer/keys

main character energy: you say "make me a key," it makes you a key ✨

---

✨ OPTIONS ✨

here's the full menu, no skips, no summaries, we're doing all of them because that's the assignment 💖

• -b, --bit-length=4096 — specify key bit length
• -C, --comment="" — key comment
• -E, --email="" — key owner email
• -h, --help[=false] — help for newpair (the classic "what does anything mean" button 🙈)
• -d, --keysdir="/builddir/.apptainer/keys" — set local keyring dir path, an alternative way is to set environment variable APPTAINER_KEYSDIR
• -N, --name="" — key owner name
• -P, --password="" — key password
• -U, --push[=false] — specify to push the public key to the remote keystore

🧚 tiny note bestie: -d has a backup plan — you can also set the environment variable APPTAINER_KEYSDIR, and it's giving "same energy, different door" ✨

---

🔥 EXAMPLE

okay so here's the glow-up, straight from the page:

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

first one: bare minimum, still slays. second one: full send with every flag in the group chat 😭💜

---

🌈 SEE ALSO

• apptainer-key(1) — go read that one too, fr fr

---

⭐ HISTORY

22-Oct-2026 — Auto generated by spf13/cobra 👑

---

aaaand that's the page, bestie 🎀 no notes, ate and left no crumbs. this lil rewrite was brought to you by Auto generated by spf13/cobra, dated Oct 2026, from the apptainer(1) manual — catch you in the next keyring 💖✨🦋