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","");
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.
Disable the S/MIME button
user_pref("extensions.enigmail.disableSMIMEui",false);
Mozilla Only.
UI: OpenPGP > Preferences > Advanced; Hide SMIME buttons/menus
On 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.
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.
GnuPG hash algorithm (currently only 1 supported!)
user_pref("extensions.enigmail.mimeHashAlgorithm",1);
UI: OpenPGP > Preferences > PGP/MIME; Hash algorithm
Default set to SHA1.
MD5 and RIPEMD160 are available for selection but will
not work currently
No passphrase for GnuPG key needed
user_pref("extensions.enigmail.noPassphrase",false);
UI: OpenPGP > Preferences > Basic; No passphrase for user
Off by default.
Enable per recipient rules (0=off / 2=ask for every unknown user)
user_pref("extensions.enigmail.perRecipientRules",1);
UI: OpenPGP > Preferences > Key Selection; Use Key Selection Rules
Default set to Define rules manually.
Enable selection of keys for unkown recipients (0=off, 1=when necessary, 2=always)
user_pref("extensions.enigmail.recipientsSelectionOption",1);
UI: OpenPGP > Preferences > Key Selection; Normal Key Selection
Default set to Display selection when necessary.
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.
Use PGP/MIME (0=never, 1=allow, 2=always)
user_pref("extensions.enigmail.usePGPMimeOption",1);
UI: OpenPGP > Preferences > PGP/MIME; Choose PGP/MIME option
Default set to Allow to use PGP/MIME.
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: 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.
Verify RFC 3156 section 6.1 messages only up to a specific size
user_pref("extensions.enigmail.encapsulatedMimeMaxSize",20000);
JS: With messages that have first been signed inline and then encrypted (see RFC 3156, section 6.1), Mozilla tends to lock up. As a workaround, Enigmail only decrypts and verifies messages up to a size that has proven to work in most cases. You might want to try 40000 (bytes) but at least in order to decrypt Apple Mail PGP/MIME messages you should stick to the default (see bug 9067).
Default: 20000 (bytes)
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.
Warn if GnuPG <= v1.0.6 (countdown)
user_pref("extensions.enigmail.gpgVersionWarnCount",1);
JS: Warns that the installed version of GnuPG is less than v1.0.6,
which is the minimum version Enigmail can work with.
Enable 'Decrypt & open' for double click on attachment (if possible)
user_pref("extensions.enigmail.handleDoubleClick",false);
JS: Enables automatic decryption and opening of encrypted attachments
with a double click.
Off 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.
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.
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.
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: 0.90.0.0
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.pgpkeyId", "");
user_pref("mail.identity.default.pgpKeyMode", 0);
user_pref("mail.identity.default.pgpSignPlain", false);
user_pref("mail.identity.default.pgpSignEncrypted", false);
user_pref("mail.identity.default.defaultEncryptionPolicy", 0);
