.TH AGE "1" "July 2020" "Debian" "User Commands"

.SH NAME
\fBage\fR \- simple, modern and secure encryption tool

.SH SYNOPSIS
\fBage\fR --recipient \fIRECIPIENT\fR [-a] [-o \fIOUTPUT\fR] [\fIINPUT\fR]
.br
\fBage\fR --decrypt [-i \fIKEY\fR] [-o \fIOUTPUT\fR] [\fIINPUT\fR]

.SH DESCRIPTION
.TP
\fB-o\fR, \fB--output\fR \fIOUTPUT\fR
Write the result to the file at path OUTPUT.

.TP
\fB-a\fR, \fB--armor\fR
Encrypt to a PEM encoded format.

.TP
\fB-p\fR, \fB--passphrase\fR
Encrypt with a passphrase.

.TP
\fB-r\fR, \fB--recipient\fR \fIRECIPIENT\fR
Encrypt to the specified RECIPIENT. Can be repeated.

.TP
\fB-d\fR, \fB--decrypt\fR
Decrypt the input to the output.

.TP
\fB-i\fR, \fB--identity\fR \fIKEY\fR
Use the private key file at path KEY. Can be repeated.

.P
\fIINPUT\fR defaults to standard input, and \fIOUTPUT\fR defaults to standard
output.

\fIRECIPIENT\fR can be an age public key, as generated by \fBage-keygen(1)\fR,
("age1...") or an SSH public key ("ssh-ed25519 AAAA...", "ssh-rsa AAAA...").

\fIKEY\fR is a path to a file with age secret keys, one per line (ignoring "#"
prefixed comments and empty lines), or to an SSH key file. Multiple keys can be
provided, and any unused ones will be ignored.

.SH EXAMPLES

.TP
Generate a key with \fBage-keygen(1)\fR:
$ age-keygen -o key.txt
.br
Public key: age1ql3z7hjy54pw3hyww5ayyfg7zqgvc7w3j2elw8zmrj2kg5sfn9aqmcac8p

.TP
Encrypt a file:
$ age -r age1ql3z7hjy54pw3hyww5ayyfg7zqgvc7w3j2elw8zmrj2kg5sfn9aqmcac8p < file > file.age

.TP
Decrypt a file:
$ age -d -i key.txt -o file file.age

.SH "SEE ALSO"
.B age-keygen(1)

.SH AUTHORS
.B Filippo Valsorda <github@filippo.io>

See https://github.com/FiloSottile/age/graphs/contributors