rage-keygen(1)

📦
version 0.12.1 · 4 versions
, in arch rolling

🎀 NAME 🎀

okay bestie, welcome to the rage-keygen(1) page from the General Commands Manual — this is all about rage-keygen, which does exactly this: Generate age-compatible encryption key pairs. ✨

✨ SYNOPSIS ✨

rage-keygen [-h|--help] [-V|--version] [-o|--output] [-y ] [INPUT]

💖 DESCRIPTION 💖

rage-keygen generates a brand-new native age key pair, and then outputs the identity to standard output or to the OUTPUT file. The output includes the public key and the current time as comments — cute little receipts, basically. 🧾💅

If the output is not going to a terminal, rage-keygen prints the public key to standard error. yep, stderr gets the little public-key moment. 🫶

🌸 ARGUMENTS 🌸

  • [INPUT] — path to a file to read from. simple as that, bestie.

🦋 OPTIONS 🦋

  • -h, --help — print this help message and exit. iconic behavior. 👑
  • -V, --version — print version info and exit. slay, short and sweet. ✨
  • -o, --output <OUTPUT> — write the identity to OUTPUT instead of standard output.

If OUTPUT already exists, it is not overwritten. no cap, it will not bulldoze your existing file. 💀

  • -y — read an identity file from INPUT or from standard input and output the corresponding recipient(s), one per line, with no comments. literally converting the identity tea into recipient lines. 🍓

🌈 EXAMPLES 🌈

Generate a new identity:

$ rage-keygen
# created: 2021-01-02T15:30:45+01:00
# public key:
age1lvyvwawkr0mcnnnncaghunadrqkmuf9e6507x9y920xxpp866cnql7dp2z
AGE-SECRET-KEY-1N9JEPW6DWJ0ZQUDX63F5A03GX8QUW7PXDE39N8UYF82VZ9PC8UFS3M7XA9

Write a new identity to "key.txt":

$ rage-keygen -o key.txt
Public key:
age1ql3z7hjy54pw3hyww5ayyfg7zqgvc7w3j2elw8zmrj2kg5sfn9aqmcac8p

Convert an identity to a recipient:

$ rage-keygen -y key.txt
age1ql3z7hjy54pw3hyww5ayyfg7zqgvc7w3j2elw8zmrj2kg5sfn9aqmcac8p

👀 SEE ALSO 👀

go read those too, bestie — the lore continues. 🦋💜

⭐ VERSION ⭐

v0.12.1

🫶 AUTHORS 🫶

Jack Grigg <thestr4d@gmail.com>

💖 cute sign-off: the footer’s source/version is rage-keygen 0.12.1, the manual is rage-keygen(1), and there’s no date shown in the original footer — no invented dates here, periodt. 🎀✨

📦 where this page comes from