SQ(1)

✨ NAME ✨

sq-key-expire — changing a certificate's expiration time, bestie edition 💖

okay so literally this is the sq manual page (SQ(1), under User Commands, iykyk) and we're talking about the subcommand that changes how long a certificate lives before it expires ✨

---

🌸 SYNOPSIS 🌸

sq key expire [OPTIONS]

---

🦋 DESCRIPTION 🦋

So here's the tea: this subcommand changes a certificate's expiration time. periodt. 💅

But listen — if you wanna change the expiration time of one individual subkey, not the whole cert, you do not come here. You go use the sq key subkey expire subcommand instead. Different vibe, different command, don't mix them up 🙈

---

🎀 OPTIONS 🎀

💜 Subcommand options

• --cert=FINGERPRINT|KEYID — changes the expiration of the key with the fingerprint or key ID you hand it. give it the exact one, no guessing, she's specific like that 👑
• --cert-email=EMAIL — changes the expiration of the key where a user ID includes the email address you specify. so if the cert's user ID has that email in it, that's your key 🍓
• --cert-file=PATH — changes the expiration of the key that gets read from PATH. yes, straight off the filesystem, main character energy 🔥
• --cert-userid=USERID — changes the expiration of the key with the specified user ID. matching by user ID, very demure, very mindful ✨
• --expiration=EXPIRATION — sets the expiration time, obviously 💫

EXPIRATION is either an ISO 8601 formatted date with an optional time, or a custom duration. A duration looks like N[ymwds] — and those letters stand for years, months, weeks, days, and seconds, respectively. (yes, that's y-m-w-d-s, in that order, no cap 👀)

Alternatively, the keyword never means it just... doesn't set an expiration time. living forever, iconic 🌈

[default: never]

• --output=FILE — writes to FILE, or to stdout if FILE is '-' 📝

🚨 bestie important: if --cert-file is used, then specifying --output is mandatory. not optional. not a suggestion. required. fr fr 💀

🌟 Global options

See sq(1) for a description of the global options. (go read the big one, she explains everything 🫶)

---

💖 EXAMPLES 💖

Change Alice's certificate to expire in a year. slay, one whole year of validity ✨

sq key expire --expiration 1y --cert \
       EB28F26E2739A4870ECC47726F0073F60FD0CBF0

Change Alice's certificate to never expire. she's eternal now, obsessed 😭💅

sq key expire --expiration never --cert \
       EB28F26E2739A4870ECC47726F0073F60FD0CBF0

---

🌈 SEE ALSO 🌈

• sq(1)
• sq-key(1)

For the full documentation see <https://book.sequoia-pgp.org/>. 👑📚

---

⭐ VERSION ⭐

1.5.0 💫

---

and that's the whole thing bestie, we ate 🍽️✨ this was Sequoia PGP, version 1.5.0, and yeah, that's the signature — nonstop, periodt 💖🦋