[[PageOutline]]

= Suggested OpenPGP software  =
== Using GnuPG on a Macintosh Computer ==

=== How do I use GnuPG with a Macintosh and Thunderbird? ===

 * Download and install [http://macgpg.sourceforge.net/ Mac GnuPrivacy Guard], or if you running 10.4 or newer, download and install [http://sourceforge.net/projects/macgpg2/ Mac GPG2]. 
 * Follow the [#HowdoIinstallandconfigureEnigmailwithThunderbird directions below to install and configure Enigmail for Thunderbird and generate a private/public key pair].

=== How do I use GnuPG with Macintosh, web mail and Firefox? ===

 * Download and install [http://macgpg.sourceforge.net/ Mac GnuPrivacy Guard and GPG Keychain Access]. There are several other packages available for download which are not required but you may find useful.
 * Run the GPG Keychain Access program and generate a new public/private key (FIXME: we need documentation on how to do this).
 * Follow the [#HowdoIinstallandconfigureFireGPGwithFirefox directions below to install and configure FireGPG for Firefox].

== Using GnuPG on a Windows Computer ==

=== How do I use GnuPG with Windows and Thunderbird? ===

 * Download and install [http://www.gnupg.org/download/index.en.html#auto-ref-2 GnuPG for Windows], which provides the core GnuPG program.
 * Follow the [#HowdoIinstallandconfigureEnigmailwithThunderbird directions below to install and configure Enigmail for Thunderbird and generate a private/public key pair].

=== How do I use GnuPG with Windows, web mail and Firefox? ===

 * Download and install [http://www.gpg4win.org/ Gpg4win], which provides a suite of encryption related packages for Windows, including GnuPG (the core program) and Gnu Privacy Assistant which is used for managing your keys.
 * Use GnuPrivacy Assistant to [#HowdoIuseGNUPrivacyAssistanttogenerateaprivatepublickeypair create a private/public key pair].
 * Follow the [#HowdoIinstallandconfigureFireGPGwithFirefox directions below to install and configure FireGPG for Firefox].

== Using GnuPG on a GNU/Linux Computer ==

Every major GNU/Linux operating system (e.g. [http://ubuntu.com Ubuntu], [http://debian.org Debian], [http://fedoraproject.org/ Fedora], etc) comes by default with GnuPG for their desktop installations. The following directions assume you are using Debian or Ubuntu or another Debian-based Linux installation. 

[http://www.gnome.org/projects/seahorse/ Seahorse] is a graphical user interface for managing your keys. It is a useful program to have regardless of whether you use Thuderbird (Icedove) or Firefox (Iceweasel) and webmail. You can install it with:

{{{
sudo aptitude install seahorse
}}}

=== How do I use GnuPG with Linux and Thunderbird (Icedove)? ===

 * Install Enigmail:
{{{
sudo aptitude install enigmail
}}}
 * Restart any Thunderbird (or Icedove) instances.
 * Follow the [#HowdoIinstallandconfigureEnigmailwithThunderbird directions below to install and configure Enigmail for Thunderbird and generate a private/public key pair].

=== How do I use GnuPG with Linux, web mail and Firefox (Iceweasel)? ===

To use with Firefox/Iceweasel and webmail, follow the [#HowdoIinstallandconfigureFireGPGwithFirefox directions below to install and configure FireGPG for Firefox].

== Specific Programs ==

=== How do I use GNU Privacy Assistant to generate a private/public key pair? ===

 * Launch GNU Privacy Assistant
 * When running for the first time, you should be prompted to use the key generation wizard. If you are not prompted to start the wizard, click Keys -> New Key...
 * Complete the wizard to generate your key.
 * Publish your key. Click Server -> Send keys...

=== How do I install and configure Enigmail with Thunderbird? ===

 * Download [http://enigmail.mozdev.org/home/ Enigmail], a plugin for Thunderbird that provides OpenPGP support. Enigmail has an excellent [http://enigmail.mozdev.org/documentation/quickstart.php manual to get you started]. Below are the quick and dirty steps:
 * [http://enigmail.mozdev.org/documentation/quickstart-ch1.php#id2533080 Install Enigmail].
 * [http://enigmail.mozdev.org/documentation/quickstart-ch2.php#id2533185 Create your private/public key].
 * Optionally, [http://enigmail.mozdev.org/documentation/quickstart-ch2.php#id2533620 publish your public key].
 * [http://enigmail.mozdev.org/documentation/quickstart-ch3.php#id2533703 Practice signing and encrypting your email]

=== How do I install and configure FireGPG with Firefox? ===

 * Click the [http://getfiregpg.org/?page=install download FireGPG] button while running Firefox. After installing FireGPG you will need to restart Firefox before you can use FireGPG.
 * FIXME: need instructions on using FireGPG to sign, verify and decrypt messages.

=== How do I know what version of Thunderbird I'm running? ===

You can see what version of Thunderbird you have by:

 * go to Thunderbird
 * click on "Help" (File menus at the top)
 * "About Mozilla Thunderbird"