summaryrefslogtreecommitdiff
diff options
context:
space:
mode:
authorAndrew Yu <andrew@andrewyu.org>2022-08-15 21:50:39 +0800
committerRobin Jarry <robin@jarry.cc>2022-08-22 14:47:41 +0200
commit226221223df151a3a3a5f8dbab540204c48571b7 (patch)
tree500752efd2ede7b73f64a421768122953d9e2b75
parent12a282c7095094a853be9f6b813a47cee5c53208 (diff)
downloadaerc-226221223df151a3a3a5f8dbab540204c48571b7.tar.gz
aerc-226221223df151a3a3a5f8dbab540204c48571b7.zip
integrations/pgp: Mention GnuPG integration.
integrations/pgp.md documents usage of the unstable internal PGP implementation. It is important to note to users that it is possible (and generally the right thing to do for production use) to use an external implementation, usually GnuPG. Signed-off-by: Andrew Yu <andrew@andrewyu.org>
-rw-r--r--integrations/pgp.md19
1 files changed, 15 insertions, 4 deletions
diff --git a/integrations/pgp.md b/integrations/pgp.md
index a5804a06..2e826ef0 100644
--- a/integrations/pgp.md
+++ b/integrations/pgp.md
@@ -4,16 +4,27 @@ title: "aerc-wiki: Integrations/PGP"
# PGP
-> At the moment PGP Support is still in it's early stages and will likely
-> change as time goes on. Tickets relating to this can be found in
+To use GnuPG, simply set the following in `aerc.conf`. Unless if you want to
+tinker with the internal implementation, **it is highly recommended that you
+use gpg or similar external implementations.**
+```conf
+[general]
+pgp-provider=gpg
+```
+
+When the above configuration option is unset or set to `internal`,
+aerc uses an internal OpenPGP implementation.
+
+> At the moment internal PGP support is still in it's early stages and will
+> likely change as time goes on. Tickets relating to this can be found in
> ~sircmpwn's tracker: [#353](https://todo.sr.ht/~sircmpwn/aerc2/353)
> [#354](https://todo.sr.ht/~sircmpwn/aerc2/354)
> [#355](https://todo.sr.ht/~sircmpwn/aerc2/355)
> [#357](https://todo.sr.ht/~sircmpwn/aerc2/357)
> [and more](https://todo.sr.ht/~sircmpwn/aerc2?search=label%3A%22pgp%22)
-**Please be aware:** at the moment PGP support requires you to export your
-private keys. Please ensure that your home directory is protected against
+**Please be aware:** at the moment internal PGP support requires you to export
+your private keys. Please ensure that your home directory is protected against
unauthorised access.
To create a PGP-Keyring and fill it with your keys from GPG, you can run the