Enigmail Configuration Manual

Enigmail User Preferences Information

Overview

Enigmail has many settings that can be accessed by means of User Preferences added to your user.js or prefs.js file.
Most of these settings can be accessed by means of the UI, and should only be set by means of a pref in user.js or prefs.js if you do not wish them ever to be changed.

Key

UI: indicates that this value can be set using the Enigmail UI
JS: indicates that this value can only be set by entering it in user.js or prefs.js

Default preference values

The default values can be reviewed in the enigmail.js source. At the end of this page, you can review the per-identity/account settings default values.


UI preferences

The last configured Enigmail version
user_pref("extensions.enigmail.configuredVersion","");

This should not be changed.


Hide many settings and menus for not advanced users
user_pref("extensions.enigmail.advancedUser",false);

UI: OpenPGP > Preferences > Basic; Display expert settings
Off by default.


Path to gpg executable
user_pref("extensions.enigmail.agentPath","");

UI: OpenPGP > Preferences > Basic; GnuPG executable path
If gpg executable is in the path, it can be left blank.


Enable --always-trust for message sending
user_pref("extensions.enigmail.alwaysTrustSend",true);

UI: OpenPGP > Preferences > Sending; Always trust user ID
On by default.


Enable automatically decrypt/verify
user_pref("extensions.enigmail.autoDecrypt",true);

UI: OpenPGP > Automatically decrypt/verify messages
On by default.


Enable confirm dialog before sending message
user_pref("extensions.enigmail.confirmBeforeSend",false);

UI: OpenPGP > Preferences > Sending; Always confirm before sending
Off by default.


Treat '-- ' as signature separator
user_pref("extensions.enigmail.doubleDashSeparator",true);

UI: OpenPGP > Preferences > Advanced; Treat '--' as signature separator
On by default.


Encrypt to self
user_pref("extensions.enigmail.encryptToSelf",true);

UI: OpenPGP > Preferences > Sending; Encrypt to self
On by default.


Disable '<' and '>' around email addresses
user_pref("extensions.enigmail.hushMailSupport",false);

UI: OpenPGP > Preferences > Advanced; Do not use '<' and '>' to specify email addresses (for Hushmail keys)
Off by default.


Debug log directory (if set, also enabled debugging)
user_pref("extensions.enigmail.logDirectory","");

UI: OpenPGP > Preferences > Debugging; Log directory
Off by default.


Enable encryption for replies to encrypted mails
user_pref("extensions.enigmail.keepSettingsForReply",true);

UI: OpenPGP > Preferences > Advanced; Encrypt if replying to encrypted message
On by default.


Display all keys in the OpenPGP Key Manager
user_pref("extensions.enigmail.keyManShowAllKeys",false);

UI: OpenPGP > Key Management: if no text is entered in the search field, display all keys (true), or none (false)
false by default.


List of keyservers to use
user_pref("extensions.enigmail.keyserver","random.sks.keyserver.penguin.de, pgp.dtype.org, keyserver.kjsl.com, ldap://certserver.pgp.com");

UI: OpenPGP > Preferences > Basic; Keyserver(s)
Default string shown above.


Keep passphrase for ... minutes
user_pref("extensions.enigmail.maxIdleMinutes",5);

UI: OpenPGP > Preferences > Basic; Remember passphrase for ... minutes of idle time
Default set to 5 minutes.


No passphrase for GnuPG key needed
user_pref("extensions.enigmail.noPassphrase",false);

UI: OpenPGP > Preferences > Basic; No passphrase for user
Off by default.


Selection of keys for unkown recipients
user_pref("extensions.enigmail.recipientsSelection",1);

UI: OpenPGP > Preferences > Key Selection

Method to use for unknown keys:
1: by rules only
2: by rules & email addresses (default)
3: by email address only (no rules)
4: manually (always prompt, no rules)
5: no rules, no key manual selection


Use GnuPG's default comment for signed messages
user_pref("extensions.enigmail.useDefaultComment",false);

UI: OpenPGP > Preferences > Advanced; Do not add Enigmail comment in OpenPGP signature
Off by default.


Use gpg passphrase agent for passphrase handling
user_pref("extensions.enigmail.useGpgAgent",false);

UI: OpenPGP > Preferences > Advanced; Use gpg-agent for passphrase handling
Off by default.
Note: if GnuPG v2.0 or newer is used, then gpg-agent is mandatory and the option is ignored.


Wrap HTML messages before sending inline PGP messages
user_pref("extensions.enigmail.wrapHtmlBeforeSend",true);

UI: OpenPGP > Preferences > Sending; Rewrap signed HTML text before sending
On by default


JS preferences

Countdown for alerts when composing inline PGP HTML messages
user_pref("extensions.enigmail.composeHtmlAlertCount",3);

JS: This sets the number of times a warning message will be shown when composing HTML messages and attempting to send using Inline PGP.


Show warning message when clicking on sign icon
user_pref("extensions.enigmail.displaySignWarn",true);

JS: Warns when changing signing by clicking on the sign icon in the bottom right hand corner of the compose pane.
On by default.


Handling of partially signed messages
user_pref("extensions.enigmail.displayPartiallySigned",true);

JS: Display message at the top of the headers in the message reading pane if only part of the message is signed.
If you set this to false, PGP headers that appear within the message body will be ignored and displayed literally – except for those PGP headers at the beginning and the end of the message body when the whole message is signed (which is the normal case).
If this is set to true, Enigmail even removes preceeding quotes (">") from signed text embedded in the rest of the body if the message itself as a whole is not signed. This only works if the embedded quote has not been modified in the slightest way.
On by default.


Try to match secondary uid to from address
user_pref("extensions.enigmail.displaySecondaryUid",true);

JS: When verifying signed messages, this option forces Enigmail to search secondary ID's on a keyring to find the matching ID for the email address used to send the message and display it instead of the default key ID.


Last state of dialog to choose encryption method if there are attachments
user_pref("extensions.enigmail.encryptAttachments",1);

JS: Stores the value of the last encryption method used when sending an attachment to an encrypted message.


Allow encryption to newsgroupds
user_pref("extensions.enigmail.encryptToNews",false);
user_pref("extensions.enigmail.warnOnSendingNewsgroups",true);

JS: Enables a warning dialog and/or sending of encrypted messages to newsgroups.


Enable 'Decrypt & open' for double click on attachment (if possible)
user_pref("extensions.enigmail.handleDoubleClick",true);

JS: Enables automatic decryption and opening of encrypted attachments with a double click.
On by default.


Countdown for 'failed to initialize enigmime'
user_pref("extensions.enigmail.initAlertCount",2);

JS: Sets the number of times a warning is displayed if Enigmime does not initialize.


Use -a for encrypting attachments for inline PGP
user_pref("extensions.enigmail.inlineAttachAsciiArmor",false);

JS: Turns on ASCII Armor for attachments to inline PGP encrypted messages.
Off by default.


Extension to append for encrypting attachments for inline PGP
user_pref("extensions.enigmail.inlineAttachExt",".pgp");

JS: Sets the extension to be used when creating attachments to inline PGP encrypted messages.


GnuPG hash algorithm
user_pref("extensions.enigmail.mimeHashAlgorithm",0);

JS: Force GnuPG to use a specific hash algorithm (0: let GnuPG choose / 1: SHA1 / 2:RIPEMD160 / 3: SHA256 / 4: SHA384 / 5: sha512 6: SHA224)
0 by default.


Prefer S/MIME or PGP/MIME
user_pref("extensions.enigmail.mimePreferPgp",1);

JS: Due tue technical reasons it is not possible to use both PGP/MIME and S/MIME in one message. This option decides which standard to choose if both are activated (after OpenPGP rules were processed).
1 by default.


Parse all mime headers (do NOT change)
user_pref("extensions.enigmail.parseAllHeaders",true);

JS: Will force Enigmail to only parse the first set of MIME headers it finds in the message.
Will cause problems if disabled. For testing purposes only


Show quoted printable warning message (and remember selected state)
user_pref("extensions.enigmail.quotedPrintableWarn",0);

JS: Warns when Enigmail detects that a message is to be sent that contains 8 bit characters and that it will use Quoted Printable encoding.
Off by default.


Use http proxy settings as set in Mozilla/Thunderbird
user_pref("extensions.enigmail.respectHttpProxy",true);

JS: Use the HTTP Proxy settings defined in Mozilla/Thunderbird when retrieving keys from keyservers.
On by default


Show "save draft encrypted" message (and remember selected state)
user_pref("extensions.enigmail.saveEncrypted",0);

JS: When saving a message that is to be sent encrypted as a draft, Enigmail checks if you would like to save the draft as an encrypted message.
On by default


Replacement of Mozilla's show all headers (because the original value is overriden)
user_pref("extensions.enigmail.show_headers",1);

JS: Both mail.show_headers and extensions.enigmail.show_headers control the viewing of the headers (normal=1 / all=2).
As Enigmail needs to see all headers, it sets mail.show_headers to 2 and stores the desired view in extensions.enigmail.show_headers.
The default is derived from the setting of mail.show_headers.
Depreciated: Thunderbird <= 2.x / SeaMonkey 1.x only.


Enable using gpgkeys_*
user_pref("extensions.enigmail.useGpgKeysTool",true);

JS: Enables Enigmail to use the gpgkeys_hkp, gpgkeys_ldap, and gpgkeys_http to retrieve keys from keyservers without using gpg itself.


Warn if gpg-agent is found and remember passphrase for X minutes is active
user_pref("extensions.enigmail.warnGpgAgentAndIdleTime",true);

JS: Shows a warning when closing the OpenPGP preferences if gpg-agent is used
On by default


Show "conflicting rules" message (and remember selected state)
user_pref("extensions.enigmail.warnOnRulesConflict",0);

JS: Shows a warning when sending a message to multiple addresses with Per-recipient rules that conflict with each other.
Off by default


Disable X-Enigmail-xxx headers
user_pref("extensions.enigmail.addHeaders",true);

JS: If this is set to true, Enigmail adds custom mail headers to all outgoing mail. These headers are not currently used for any function, but may be used by a future Enigmail specific function.
Currently the headers added are:
    X-Enigmail-Version: 1.2.1
    X-Enigmail-Supports: pgp-inline, pgp-mime

On by default.



Default pref values for the Enigmail per-identity Account Settings

user_pref("mail.identity.default.enablePgp",false);
user_pref("mail.identity.default.attachPgpKey",false);
user_pref("mail.identity.default.pgpkeyId", "");
user_pref("mail.identity.default.pgpKeyMode", 0);
user_pref("mail.identity.default.pgpMimeMode", false);
user_pref("mail.identity.default.pgpSignPlain", false);
user_pref("mail.identity.default.pgpSignEncrypted", false);
user_pref("mail.identity.default.defaultEncryptionPolicy", 0);