Apply conversion script to all *.md files. authored by Alexander Hansen Færøy's avatar Alexander Hansen Færøy
[[TOC]]
=== Proxy ===
[[Image(https://people.torproject.org/~sukhbir/screenshots/proxy.png)]] ### Proxy
==== - Use the recommended proxy settings for TorBirdy (Tor) ==== ![https://people.torproject.org/~sukhbir/screenshots/proxy.png](https://people.torproject.org/~sukhbir/screenshots/proxy.png)
#### - Use the recommended proxy settings for TorBirdy (Tor)
When this option is selected, TorBirdy will change the proxy settings of Thunderbird to configure it to use the Tor network. The settings this options changes are: When this option is selected, TorBirdy will change the proxy settings of Thunderbird to configure it to use the Tor network. The settings this options changes are:
...@@ -14,11 +14,11 @@ When this option is selected, TorBirdy will change the proxy settings of Thunder ...@@ -14,11 +14,11 @@ When this option is selected, TorBirdy will change the proxy settings of Thunder
This is the default option when TorBirdy is installed. This is the default option when TorBirdy is installed.
==== - Choose an anonymization service ==== #### - Choose an anonymization service
TorBirdy has native support for [https://whonix.org Whonix] and [https://anonymous-proxy-servers.net/index.html JonDos]. TorBirdy has native support for [Whonix](https://whonix.org) and [JonDos](https://anonymous-proxy-servers.net/index.html).
'''Whonix''' **Whonix**
The Whonix documentation covers installation and configuration of TorBirdy. Please see: https://www.whonix.org/wiki/E-Mail#Mozilla_Thunderbird_with_TorBirdy for more information. The Whonix documentation covers installation and configuration of TorBirdy. Please see: https://www.whonix.org/wiki/E-Mail#Mozilla_Thunderbird_with_TorBirdy for more information.
...@@ -29,7 +29,7 @@ When Whonix is enabled, the following settings are changed: ...@@ -29,7 +29,7 @@ When Whonix is enabled, the following settings are changed:
When TorBirdy starts on Whonix, it checks for the `WHONIX` environment variable. If it is found, TorBirdy configures itself to use the Whonix settings automatically; no further configuration is required from the user. When TorBirdy starts on Whonix, it checks for the `WHONIX` environment variable. If it is found, TorBirdy configures itself to use the Whonix settings automatically; no further configuration is required from the user.
'''JonDo''' **JonDo**
The JonDo documentation covers installation and configuration of TorBirdy. Please see: https://anonymous-proxy-servers.net/en/help/thunderbird.html for more information. The JonDo documentation covers installation and configuration of TorBirdy. Please see: https://anonymous-proxy-servers.net/en/help/thunderbird.html for more information.
...@@ -42,36 +42,36 @@ When JonDo is enabled, the following settings are changed: ...@@ -42,36 +42,36 @@ When JonDo is enabled, the following settings are changed:
* HTTP host: `127.0.0.1` * HTTP host: `127.0.0.1`
* HTTP port: `4001` * HTTP port: `4001`
* Pipelining is disabled * Pipelining is disabled
* `network.http.pipelining`: '''false''' * `network.http.pipelining`: **false**
* `network.http.pipelining.ssl`: '''false''' * `network.http.pipelining.ssl`: **false**
* `network.http.proxy.pipelining`: '''false''' * `network.http.proxy.pipelining`: **false**
* Enigmail keyserver: `hkp://pool.sks-keyservers.net` * Enigmail keyserver: `hkp://pool.sks-keyservers.net`
==== - Use custom proxy settings ==== #### - Use custom proxy settings
Select this option if you want to use a custom SOCKS host and port that Thunderbird should connect to when TorBirdy is enabled. An example of where this can be useful is if you have an anonymization service running on some host/port other than the default hard-coded ones. Select this option if you want to use a custom SOCKS host and port that Thunderbird should connect to when TorBirdy is enabled. An example of where this can be useful is if you have an anonymization service running on some host/port other than the default hard-coded ones.
'''Note''': If you change the network settings from Thunderbird's preferences, they will be overwritten by TorBirdy. Therefore, if you have to change the SOCKS port and host Thunderbird should connect to when TorBirdy is enabled, you should specify them using the above settings. **Note**: If you change the network settings from Thunderbird's preferences, they will be overwritten by TorBirdy. Therefore, if you have to change the SOCKS port and host Thunderbird should connect to when TorBirdy is enabled, you should specify them using the above settings.
==== - Transparent Torification ==== #### - Transparent Torification
'''WARNING''': Do not select this option without understanding what it does. **WARNING**: Do not select this option without understanding what it does.
Selecting this option clears the proxy settings (Thunderbird will not use any anonymization service) but keeps all other privacy settings intact. This is useful if you are using TorBirdy behind a Tor router or you want to keep the TorBirdy-recommended settings but do not want to perform some operation over Tor, like connecting to some specific email account or updating Thunderbird. See comment:1:ticket:8487 for more information. Selecting this option clears the proxy settings (Thunderbird will not use any anonymization service) but keeps all other privacy settings intact. This is useful if you are using TorBirdy behind a Tor router or you want to keep the TorBirdy-recommended settings but do not want to perform some operation over Tor, like connecting to some specific email account or updating Thunderbird. See comment:1:ticket:8487 for more information.
=== Privacy === ### Privacy
[[Image(https://people.torproject.org/~sukhbir/screenshots/privacy.png)]] ![https://people.torproject.org/~sukhbir/screenshots/privacy.png](https://people.torproject.org/~sukhbir/screenshots/privacy.png)
'''Note''': Changes made to the settings under the ''Global'' header will affect all email accounts. You '''cannot''' change these settings on a per-account basis because Thunderbird does not allow that. **Note**: Changes made to the settings under the _Global_ header will affect all email accounts. You **cannot** change these settings on a per-account basis because Thunderbird does not allow that.
==== - Enable push email support for IMAP accounts ==== #### - Enable push email support for IMAP accounts
(Discussed in #6337) (Discussed in #6337)
TorBirdy disables IMAP `IDLE` in Thunderbird, which means that push email support is disabled and new messages will not be delivered to your email client automatically by the server. If you enable this option, all IMAP-based email accounts will have IDLE support enabled and you will be notified of new messages automatically. TorBirdy disables IMAP `IDLE` in Thunderbird, which means that push email support is disabled and new messages will not be delivered to your email client automatically by the server. If you enable this option, all IMAP-based email accounts will have IDLE support enabled and you will be notified of new messages automatically.
==== - Select last accessed mail folder on startup ==== #### - Select last accessed mail folder on startup
(Discussed in #6336, #6337) (Discussed in #6336, #6337)
...@@ -82,29 +82,29 @@ TorBirdy disables IMAP `IDLE` in Thunderbird, which means that push email suppor ...@@ -82,29 +82,29 @@ TorBirdy disables IMAP `IDLE` in Thunderbird, which means that push email suppor
TorBirdy prevents Thunderbird from automatically checking for new messages at startup and after a fixed time interval (usually ten minutes), which is Thunderbird's default behaviour. TorBirdy prevents Thunderbird from automatically checking for new messages at startup and after a fixed time interval (usually ten minutes), which is Thunderbird's default behaviour.
TorBirdy will not select any account when Thunderbird starts to prevent it from automatic logging in to your last accessed email account. If you enable this option, TorBirdy ''will'' log in to the last email account you accessed and check and download new messages, ''even'' if the ''Check for new messages at startup'' preference for that account is enabled. TorBirdy will not select any account when Thunderbird starts to prevent it from automatic logging in to your last accessed email account. If you enable this option, TorBirdy _will_ log in to the last email account you accessed and check and download new messages, _even_ if the _Check for new messages at startup_ preference for that account is enabled.
To enable automatic checking of emails for: To enable automatic checking of emails for:
* All Accounts * All Accounts
Open TorBirdy's preferences and go to ''Privacy''. In the ''Account-Specific'' options, check the option ''Check for new messages automatically for all accounts''. This will allow Thunderbird to revert to its default behaviour where it checks for new periodically and at startup for all accounts. Open TorBirdy's preferences and go to _Privacy_. In the _Account-Specific_ options, check the option _Check for new messages automatically for all accounts_. This will allow Thunderbird to revert to its default behaviour where it checks for new periodically and at startup for all accounts.
* Specific Accounts * Specific Accounts
If you want to change this setting for specific accounts, you have to follow the steps below, independent of how many accounts you want to change. If you want to change this setting for specific accounts, you have to follow the steps below, independent of how many accounts you want to change.
* Go to ''Privacy'', and under ''Global'', select ''Enable push email support for IMAP accounts'' and ''Select last accessed mail folder on startup''. As these options come under the ''Global'' settings, you have to just change them once and then perform the next step, on all accounts you want to change. * Go to _Privacy_, and under _Global_, select _Enable push email support for IMAP accounts_ and _Select last accessed mail folder on startup_. As these options come under the _Global_ settings, you have to just change them once and then perform the next step, on all accounts you want to change.
Then see ''Account-Specific'' options, choose your email account, and enable the account-specific settings you want. If you want the default Thunderbird settings, check both the options in the account configuration window. Then see _Account-Specific_ options, choose your email account, and enable the account-specific settings you want. If you want the default Thunderbird settings, check both the options in the account configuration window.
==== - Enable Thunderbird's automatic email configuration wizard ==== #### - Enable Thunderbird's automatic email configuration wizard
[[Image(https://people.torproject.org/~sukhbir/screenshots/manual.png)]] ![https://people.torproject.org/~sukhbir/screenshots/manual.png](https://people.torproject.org/~sukhbir/screenshots/manual.png)
If you wish to disable the manual configuration wizard and use Thunderbird's default automatic wizard, check this option. '''WARNING''': Enabling this can leak your identity. Make sure you read the following section for more information on what this preference does. If you wish to disable the manual configuration wizard and use Thunderbird's default automatic wizard, check this option. **WARNING**: Enabling this can leak your identity. Make sure you read the following section for more information on what this preference does.
Thunderbird's automatic email configuration wizard leaks your identity when setting up a new account; tickets [https://bugzilla.mozilla.org/show_bug.cgi?id=664633 #664633], [https://bugzilla.mozilla.org/show_bug.cgi?id=669282 #669282] on Bugzilla, and Section 3.6.5 of [https://trac.torproject.org/projects/tor/attachment/wiki/doc/TorifyHOWTO/EMail/Thunderbird/Thunderbird%2BTor.pdf tagnaq's paper] discuss the leaks in more detail. To protect your anonymity, TorBirdy disables the automatic configuration wizard and forces you to configure your account manually, helping you in the process by setting some of the recommended security settings automatically. Thunderbird's automatic email configuration wizard leaks your identity when setting up a new account; tickets [#664633](https://bugzilla.mozilla.org/show_bug.cgi?id=664633), [#669282](https://bugzilla.mozilla.org/show_bug.cgi?id=669282) on Bugzilla, and Section 3.6.5 of [tagnaq's paper](https://trac.torproject.org/projects/tor/attachment/wiki/doc/TorifyHOWTO/EMail/Thunderbird/Thunderbird%2BTor.pdf) discuss the leaks in more detail. To protect your anonymity, TorBirdy disables the automatic configuration wizard and forces you to configure your account manually, helping you in the process by setting some of the recommended security settings automatically.
When you create a new account with TorBirdy's manual configuration wizard, you start by selecting the type of account you want: POP3 or IMAP. TorBirdy will then set some of the recommended security settings automatically: When you create a new account with TorBirdy's manual configuration wizard, you start by selecting the type of account you want: POP3 or IMAP. TorBirdy will then set some of the recommended security settings automatically:
...@@ -129,17 +129,17 @@ Tails has fixed the above leaks in Thunderbird's automatic configuration wizard, ...@@ -129,17 +129,17 @@ Tails has fixed the above leaks in Thunderbird's automatic configuration wizard,
You can change the rest of the account settings manually if required, but you should not change any security settings that you are unsure about. When in doubt, please ask us instead of making decisions on your own. You can change the rest of the account settings manually if required, but you should not change any security settings that you are unsure about. When in doubt, please ask us instead of making decisions on your own.
We also have a [https://people.torproject.org/~sukhbir/torbirdy-gmail.ogv video] (ogv) that shows how you can configure a Gmail account with TorBirdy's manual account configuration wizard. We also have a [video](https://people.torproject.org/~sukhbir/torbirdy-gmail.ogv) (ogv) that shows how you can configure a Gmail account with TorBirdy's manual account configuration wizard.
==== - Check for new messages automatically for all accounts ==== #### - Check for new messages automatically for all accounts
TorBirdy disables the automatic checking of messages for all configured accounts. However, there are cases for which you need to enable this feature; checking this enables automatic message fetching, which is also the default mode in Thunderbird. (Also see [#a-Selectlastaccessedmailfolderonstartup Select last accessed mail folder on startup] section above.) TorBirdy disables the automatic checking of messages for all configured accounts. However, there are cases for which you need to enable this feature; checking this enables automatic message fetching, which is also the default mode in Thunderbird. (Also see [#a-Selectlastaccessedmailfolderonstartup Select last accessed mail folder on startup] section above.)
=== Enigmail === ### Enigmail
[[Image(https://people.torproject.org/~sukhbir/screenshots/enigmail.png)]] ![https://people.torproject.org/~sukhbir/screenshots/enigmail.png](https://people.torproject.org/~sukhbir/screenshots/enigmail.png)
==== - Confirm before sending email if Enigmail is enabled ==== #### - Confirm before sending email if Enigmail is enabled
Default:: Default::
Do not confirm. Do not confirm.
...@@ -154,7 +154,7 @@ This is enabled for all accounts. ...@@ -154,7 +154,7 @@ This is enabled for all accounts.
Default Value:: Default Value::
False False
==== - Do not put the recipient key IDs into encrypted messages ==== #### - Do not put the recipient key IDs into encrypted messages
Default Value:: Default Value::
Recipient key IDs are included into encrypted messages. Recipient key IDs are included into encrypted messages.
...@@ -167,7 +167,7 @@ Please see https://lists.torproject.org/pipermail/tor-talk/2012-July/024854.html ...@@ -167,7 +167,7 @@ Please see https://lists.torproject.org/pipermail/tor-talk/2012-July/024854.html
In earlier version of TorBirdy, this was enabled by default and encrypted messages did not have the recipients key IDs included in the message. This was changed in 0.1.2, because a lot of users complained about this option being enabled by default. (Discussed in #6941, #9648) In earlier version of TorBirdy, this was enabled by default and encrypted messages did not have the recipients key IDs included in the message. This was changed in 0.1.2, because a lot of users complained about this option being enabled by default. (Discussed in #6941, #9648)
==== - Disable encrypted email headers ==== #### - Disable encrypted email headers
Default:: Default::
Encrypted email headers are enabled. Encrypted email headers are enabled.
...@@ -180,6 +180,6 @@ By default, TorBirdy enables encrypted email headers in Enigmail (as defined by ...@@ -180,6 +180,6 @@ By default, TorBirdy enables encrypted email headers in Enigmail (as defined by
Default Value:: Default Value::
True True
==== - Keyserver(s) to use ==== #### - Keyserver(s) to use
Enter the keyserver(s) you wish to use with Enigmail (and therefore GPG). You can enter multiple keyservers in this field, separated by a comma. By default, Tor and Whonix use the hkp://jirk5u4osbsr34t5.onion keyserver and JonDo uses hkp://pool.sks-keyservers.net. (See #7093). When you select an anonymization service from the ''Proxy'' settings, the keyserver field is automatically updated with the default value corresponding to that service (whether Tor/Whonix or JonDo). Enter the keyserver(s) you wish to use with Enigmail (and therefore GPG). You can enter multiple keyservers in this field, separated by a comma. By default, Tor and Whonix use the hkp://jirk5u4osbsr34t5.onion keyserver and JonDo uses hkp://pool.sks-keyservers.net. (See #7093). When you select an anonymization service from the _Proxy_ settings, the keyserver field is automatically updated with the default value corresponding to that service (whether Tor/Whonix or JonDo).
\ No newline at end of file \ No newline at end of file