Commit 582e35d9 authored by sajolida's avatar sajolida
Browse files

Merge branch 'doc/7158-icedove' into web/10452-1.7-release-notes

parents 6bd8ea3a 6729b96a
......@@ -26,7 +26,7 @@ Roadmap
1. List blockers (from the *Things to implement* list below).
1. Implement blockers.
1. Write design documentation.
1. Adapt [[end-user documentation|doc/anonymous_internet/thunderbird]]
1. Adapt end-user documentation
from Incognito.
Design decisions
......
......@@ -36,6 +36,7 @@ Networking
Messaging ([[More...|doc/anonymous_internet/pidgin]])
* [Claws Mail](http://www.claws-mail.org/) e-mail client, with
GnuPG support ([[More...|doc/anonymous_internet/Claws_Mail]])
* [Icedove (Thunderbird)](https://www.mozilla.org/en-US/thunderbird/) email client with [Enigmail](https://www.enigmail.net/) for OpenPGP support ([[More...|doc/anonymous_internet/icedove]])
* [Liferea](http://liferea.sourceforge.net/) feed aggregator
* [Gobby](http://gobby.0x539.de/trac/) for collaborative text writing
* [Aircrack-ng](http://aircrack-ng.org/) for wireless networks auditing
......
......@@ -4,6 +4,8 @@
- [[!traillink Browsing_the_web_with_<span_class="application">Tor_Browser</span>|anonymous_internet/tor_browser]]
- [[!traillink Chatting_with_Pidgin_&_OTR|anonymous_internet/pidgin]]
- [[!traillink Reading_and_writing_emails_with_<span_class="application">Claws_Mail</span>|anonymous_internet/claws_mail]]
- [[!traillink Emailing_with_<span_class="application">Icedove_(Thunderbird)</span>|anonymous_internet/icedove]]
- [[!traillink Migrating_from_<span_class="application">Claws_Mail</span>_to_<span_class="application">Icedove</span>|anonymous_internet/claws_mail_to_icedove]]
- [[!traillink Exchange_bitcoins_using_<span_class="application">Electrum</span>|anonymous_internet/electrum]]
- [[!traillink Using_I2P|anonymous_internet/i2p]]
- [[!traillink Why_Tor_is_slow?|anonymous_internet/why_tor_is_slow]]
[[!meta title="Migrating from Claws Mail to Icedove"]]
Tails is replacing <span class="application">[[Claws Mail]]</span> with
<span class="application">[[Icedove]]</span> as its email client.
[[!inline pages="doc/anonymous_internet/icedove/name.inline" raw="yes"]]
- In Tails 1.7, <span class="application">Icedove</span> is available
as a technology preview.
- In Tails 1.8 (2015-12-15), <span class="application">Icedove</span>
will be the default email client in Tails and all users will be encouraged to migrate to
<span class="application">Icedove</span>.
- In Tails 1.9 (2016-01-26), <span class="application">Claws Mail</span>
will be removed from Tails.
If you have been using <span class="application">Claws Mail</span> and activated its persistence feature,
the following instructions explain how to migrate your data to <span class="application">Icedove</span>.
We recommend you do the migration before launching <span class="application">Icedove</span> for the first
time. You should, in this order:
[[!toc]]
<a id="mailboxes"></a>
Copy your emails saved in the persistent storage
================================================
1. Start Tails and [[set up an administration password|first_steps/startup_options/administration_password]].
1. Start <span class="application">Claws Mail</span>.
1. To know if you are using the IMAP or the POP protocol, choose <span class="menuchoice">
<span class="guimenu">Configuration</span>&nbsp;▸
<span class="guimenuitem">Edit accounts&hellip;</span></span>
and refer to the <span class="guilabel">Protocol</span> column in the
list of accounts.
- If you use IMAP, your emails are stored on the remote email server and
you can skip this section and start [[configuring your email account
in <span class="application">Icedove</span>|claws_mail_to_icedove#settings]].
- If you use POP and have emails saved in the persistent storage, we
propose in the following steps a script to copy your emails from
<span class="application">Claws Mail</span> to
<span class="application">Icedove</span>.
1. Verify that both the <span class="application">Claws Mail</span> and
<span class="application">Icedove</span> persistence features are
activated. Otherwise, you might loose data.
1. The script only migrates the mailbox in
<span class="filename">/home/amnesia/.claws-mail/Mail</span> which is the default
in Tails.
Verify that there is a single <span class="guilabel">MH</span> mailbox named
<span class="guilabel">Mail</span> in the left pane of
<span class="application">Claws Mail</span> like in the following
screenshot:
[[!img single_mh.png alt="" link="no"]]
If you have several <span class="guilabel">MH</span> mailboxes in
<span class="application">Claws Mail</span>, please move all your emails into
the one corresponding to <span class="filename">/home/amnesia/.claws-mail/Mail</span>.
1. Choose <span class="menuchoice"><span class="guimenu">Applications</span>&nbsp;▸
<span class="guisubmenu">Accessories</span>&nbsp;▸
<span class="guimenuitem">Terminal</span></span> to open a terminal.
1. Execute the following command to install the `nmh` package:
sudo apt-get update ; sudo apt-get install nmh
1. Execute the following command to download the migration script:
wget https://tails.boum.org/misc/claws_to_icedove.sh
1. Execute the following command to run the migration script:
bash claws_to_icedove.sh
<div class="note">
<p>If you had started <span class="application">Icedove</span> already, the script might propose you to
back up the existing <span class="application">Icedove</span> email folders before doing the
migration. If you have valuable data in these folders, you can access
it again after the migration by doing the following:</p>
<ol>
<li>In <span class="application">Icedove</span>, choose
<span class="menuchoice">
<span class="guimenu">[[!img icedove/menu.png alt="Menu" class=symbolic link=no]]</span>&nbsp;▸
<span class="guisubmenu">Preferences</span>&nbsp;▸
<span class="guimenuitem">Account Settings</span></span>.</li>
<li>Click <span class="button">Browse&hellip;</span> in the
<span class="guilabel">Message Storage</span> section of the
<span class="guilabel">Local Folders</span> settings.</li>
<li>Navigate to <span class="filename">/home/amnesia/.icedove/profile.default/Mail.</li>
<li>Open the <span class="filename">Local Folders Backup</span>
folder that matches the date and time when you first ran the
script.</li>
</ol>
</div>
1. Continue with the next section to configure your email account in
<span class="application">Icedove</span>.
<a id="settings"></a>
Configure your email accounts in <span class="application">Icedove</span>
=========================================================================
1. Choose
<span class="menuchoice">
<span class="guimenu">Applications</span>&nbsp;▸
<span class="guisubmenu">Internet</span>&nbsp;▸
<span class="guimenuitem">Icedove</span>
</span>
to start <span class="application">Icedove</span>.
[[!inline pages="doc/anonymous_internet/icedove/account_creation.inline" raw="yes"]]
<div class="tip">
<p>If you want to compare with the settings in
<span class="application">Claws Mail</span>, choose
<span class="menuchoice">
<span class="guimenu">Configuration</span>&nbsp;▸
<span class="guimenuitem">Edit Accounts&hellip;</span>
</span> in <span class="application">Claws Mail</span>, then select
your email account and click <span class="guilabel">Edit</span>.</p>
</div>
1. If you want to configure another email account, choose
<span class="guilabel">Account Actions</span>&nbsp;▸
<span class="guilabel">Add Mail Account&hellip;</span>.
Otherwise, click <span class="guilabel">OK</span>.
For further documentation, refer to the [official
<span class="application">Thunderbird</span>
help](https://support.mozilla.org/en-US/products/thunderbird).
<a id="address_book"></a>
Migrate your address book
=========================
To export an address book from
<span class="application">Claws Mail</span> do the following:
1. Choose <span class="menuchoice">
<span class="guimenu">Tools</span>&nbsp;▸
<span class="guimenuitem">Address Book</span></span>.
1. Select an address book, for example <span class="guilabel">Common
addresses</span>, in the left pane.
1. Choose <span class="menuchoice">
<span class="guimenu">Tools</span>&nbsp;▸
<span class="guimenuitem">Export LDIF&hellip;</span></span>.
1. Specify where to save the address book as an LDIF file, then click
<span class="guilabel">Forward</span>. You can use the default
setting.
1. Enter <span class="command">claws</span> as
<span class="guilabel">Suffix</span>, then click
<span class="guilabel">Forward</span> and
<span class="guilabel">Close</span>.
To import an address book into
<span class="application">Icedove</span> do the following:
1. Choose <span class="menuchoice">
<span class="guimenu">Tools</span>&nbsp;▸
<span class="guimenuitem">Import&hellip;</span></span>.
1. Select <span class="guilabel">Text file (LDIF, .tab, .csv, .txt)</span>
and click <span class="guilabel">Next</span>.
1. Specify the LDIF file that you exported from
<span class="application">Claws Mail</span>, by default
<span class="filename">/home/amnesia/claws-mail-out/addressbook.ldif</span>.
You can repeat these steps for every address book in
<span class="application">Claws Mail</span>.
<a id="delete"></a>
Delete all your <span class="application">Claws Mail</span> data
================================================================
Once you made sure that all your data (emails, email account settings,
and address books) is imported into <span class="application">Icedove</span>,
you can delete all your <span class="application">Claws Mail</span> data.
To do so:
1. Choose <span class="menuchoice">
<span class="guimenu">Places</span>&nbsp;▸
<span class="guimenuitem">Home Folder</span>
</span> in the top navigation bar to open the file browser.
1. Choose <span class="menuchoice">
<span class="guimenu">View</span>&nbsp;▸
<span class="guimenuitem">Show Hidden Files</span></span>.
1. Open the <span class="guilabel">.claws-mail</span> folder.
1. Choose <span class="menuchoice">
<span class="guimenu">Edit</span>&nbsp;▸
<span class="guimenuitem">Select All</span></span>.
1. Choose <span class="menuchoice">
<span class="guimenu">Edit</span>&nbsp;▸
<span class="guimenuitem">Wipe</span>
</span> and confirm.
[[!meta title="Emailing with Icedove (Thunderbird)"]]
<div class="bug">
<p>Icedove has been added to Tails 1.7 as a technology preview. Icedove
is safe to use in the context of Tails but it will be better integrated
in future versions until we remove <span class="application">[[Claws
Mail|claws_mail]]</span>.</p>
</div>
<div class="note">
<p>If you have been using <span class="application">Claws Mail</span>
and activated its persistence feature, follow our instructions to
[[migrate your data to <span class="application">Icedove</span>|claws_mail_to_icedove]].
</div>
For reading and writing emails, Tails includes <span
class="application">Icedove</span>.
[[!inline pages="doc/anonymous_internet/icedove/name.inline" raw="yes"]]
To start <span class="application">Icedove</span> choose
<span class="menuchoice">
<span class="guimenu">Applications</span>&nbsp;▸
<span class="guisubmenu">Internet</span>&nbsp;▸
<span class="guimenuitem">Icedove</span></span>.
<div class="tip">
<p>You can activate the [[<strong>Icedove</strong> persistence
feature|doc/first_steps/persistence/configure#icedove]] to store your
emails and settings across separate working sessions.</p>
</div>
For more detailed documentation, refer to the [official
<span class="application">Thunderbird</span>
help](https://support.mozilla.org/en-US/products/thunderbird).
Configure an email account
==========================
[[!inline pages="doc/anonymous_internet/icedove/account_creation.inline" raw="yes"]]
OpenPGP encryption with Enigmail
================================
<span class="application">Icedove</span> in Tails includes the
<span class="application">[Enigmail](https://www.enigmail.net/)</span>
extension to encrypt and authenticate emails using OpenPGP.
To configure <span class="application">Enigmail</span> for your email account, you can start the
<span class="application">Enigmail Setup Wizard</span> by choosing
<span class="menuchoice">
<span class="guimenu">[[!img menu.png alt="Menu" class=symbolic link=no]]</span>&nbsp;▸
<span class="guisubmenu">Enigmail</span>&nbsp;▸
<span class="guimenuitem">Setup Wizard</span></span>.
You can also create an OpenPGP key associated with your email address as
part of the <span class="application">Enigmail Setup Wizard</span>.
If you are new to OpenPGP, you can read the following guides on getting
started with encrypting emails using
<span class="application">Icedove</span> and
<span class="application">Enigmail</span>:
- [Security-in-a-Box: Thunderbird & OpenPGP - secure email](https://securityinabox.org/en/guide/thunderbird/windows)
- [Enigmail: Enigmail Quick Start Guide](https://www.enigmail.net/documentation/quickstart.php)
Enhanced privacy with TorBirdy
==============================
<span class="application">Icedove</span> in Tails includes the
<span class="application">[TorBirdy](https://trac.torproject.org/projects/tor/wiki/torbirdy)</span>
extension for additional privacy and anonymity.
<div class="note">
<p>Sending emails in HTML format is disabled by <span class="application">TorBirdy</span>. Emails received in HTML format
are displayed in plain text and can become harder to read.</p>
</div>
To learn more about the security properties of <span class="application">TorBirdy</span>,
you can read its [design document](https://trac.torproject.org/projects/tor/attachment/wiki/doc/TorifyHOWTO/EMail/Thunderbird/Thunderbird%2BTor.pdf).
1. When starting <span class="application">Icedove</span> for the first
time, an assistant appears to guide you through the process of
configuring <span class="application">Icedove</span> to access your
email account.
[[!img icedove/assistant.png link="no"]]
<div class="tip">
<p>To start this assistant again in the future from the main window of
<span class="application">Icedove</span>, choose
<span class="menuchoice">
<span class="guimenu">[[!img menu.png alt="Menu" class=symbolic link=no]]</span>&nbsp;▸
<span class="guisubmenu">Preferences</span>&nbsp;▸
<span class="guimenuitem">Account Settings</span>
</span> and then from the <span class="guilabel">Account Settings</span>
dialog choose <span class="guilabel">Account Actions</span>&nbsp;▸
<span class="guilabel">Add Mail Account&hellip;</span>.</p>
</div>
1. Enter your name, email address, and password into the corresponding fields.
<a id="protocol"></a>
1. Specify which protocol to use to connect to your email provider.
<span class="application">Icedove</span> can connect to your email
provider using either the <span class="guilabel">IMAP</span> or
<span class="guilabel">POP</span> protocol.
- With <span class="guilabel">IMAP</span>,
<span class="application">Icedove</span> constantly synchronizes
with the server and displays the emails and folders that are
currently stored on the server. IMAP is better suited if you access
your emails from different operating systems.
- With <span class="guilabel">POP</span>,
<span class="application">Icedove</span> downloads the emails that
are in the inbox on the server and possibly deletes them from the
server. POP is better suited if you access your emails from Tails only
and store them in the persistent storage.
To know more, see also this [comparison between POP and
IMAP](https://help.riseup.net/en/email/clients/#choose-imap-or-pop) by
Riseup.
1. Click <span class="guilabel">Continue</span>.
<div class="bug">
<p>After this first screen, the <a href="https://support.mozilla.org/en-US/kb/automatic-account-configuration">automatic
account configuration</a> of <span class="application">Icedove</span>
is currently disabled in Tails for security reasons. You should consult
the documentation of your email provider to finish configuring your
email account manually.</p>
<p>We will enable again the automatic account configuration in Tails
1.9.</p>
</div>
<div class="tip">
<p>For [[!wikipedia Mozilla_Corporation_software_rebranded_by_the_Debian_project desc="trademark reasons"]],
<span class="application">Icedove</span> is the name of
<span class="application">Mozilla Thunderbird</span> in Tails and they
are otherwise the same program.</p>
</div>
[[!meta title="Emailing with Thunderbird"]]
**FIXME**: This section have not been adapted now so please do not take it into
account. Tails uses Claws Mail instead of Thunderbird.
Not everyone is happy using webmail (like the authors) but want to use
a _real_ email client instead of some fragile web-based interface. For
that we have included Mozilla Thunderbird which looks like this:
<center><a href="tb-main.jpg"><img border="0" height="305"
src="tb-main.jpg" width="453" /></a></center>
Composing email looks like this:
<center><a href="tb-compose.jpg"><img border="0" height="257"
src="tb-compose.jpg" width="324" /></a></center>
Notice that there are buttons for PGP encryption in both of the above
windows (labelled with "Decrypt" and "OpenPGP"). These are provided by
the [Enigmail](http://http://enigmail.mozdev.org/) extension, and
pressing any of them for the first time will start a guide for setting
up PGP, possibly generating new keys if you do not have any. Their web
site is a great resource for learning how PGP encryption works so make
sure to check it out.
Setting up your email account requires a tiny amount of knowledge,
like what [POP](http://en.wikipedia.org/wiki/Post_Office_Protocol),
[IMAP](http://en.wikipedia.org/wiki/IMAP) and
[SMTP](http://en.wikipedia.org/wiki/SMTP) is, and indeed that your
email service supports these. [This step-by-step
guide](http://opensourcearticles.com/articles/thunderbird_15/english/part_01)
might be useful. However, this initial configuration requires writing
down the addresses of the servers involved, downloading mail, etc.
which will take some time. It is a bit annoying to have to redo
everytime you start Tails, which is necessary when running from a
DVD, so you might want to consider using a persistent home directory by
[running from USB](#usb) if you plan to use Thunderbird often. One
more thing to consider is that Tor exit nodes usually block the
plaintext SMTP port (25) in order to prevent spam. This is easily
fixed by enabling end-to-end encryption with the email server through
SSL, which you should do any way for all of POP, IMAP and SMTP as your
password otherwise will be sent in plaintext.
......@@ -222,6 +222,40 @@ To save passwords, for example the passwords of encrypted wireless connections,
the [[<span class="application">GNOME Keyring</span> persistence
feature|configure#gnome_keyring]] must also be activated.
<a id="browser_bookmarks"></a>
<div class="icon">
[[!img user-bookmarks.png link=no]]
<div class="text"><h2>Browser bookmarks</h2></div>
</div>
When this feature is activated, changes to the bookmarks in
[[<span class="application">Tor Browser</span>|doc/anonymous_internet/Tor_Browser]]
are saved in the persistent volume. This does not apply to the
[[<span class="application">Unsafe Browser</span>|doc/anonymous_internet/unsafe_browser]].
<a id="printers"></a>
<div class="icon">
[[!img printer.png link=no]]
<div class="text"><h2>Printers</h2></div>
</div>
When this feature is activated, the
[[configuration of the printers|doc/sensitive_documents/printing_and_scanning]]
is saved in the persistent volume.
<a id="bitcoin"></a>
<div class="icon">
[[!img electrum.png link=no]]
<div class="text"><h2>Bitcoin Client</h2></div>
</div>
When this feature is activated, the bitcoin wallet and preferences of
the [[*Electrum* bitcoin client|anonymous_internet/electrum]] are saved in the
persistent volume.
<a id="apt_packages"></a>
<div class="icon">
......@@ -266,39 +300,17 @@ The <span class="emphasis">APT lists</span> are needed to
or explore the list of available software packages. This feature
allows you to reuse them during future working sessions, even offline.
<a id="browser_bookmarks"></a>
<div class="icon">
[[!img user-bookmarks.png link=no]]
<div class="text"><h2>Browser bookmarks</h2></div>
</div>
When this feature is activated, changes to the bookmarks in
[[<span class="application">Tor Browser</span>|doc/anonymous_internet/Tor_Browser]]
are saved in the persistent volume. This does not apply to the
[[<span class="application">Unsafe Browser</span>|doc/anonymous_internet/unsafe_browser]].
<a id="printers"></a>
<div class="icon">
[[!img printer.png link=no]]
<div class="text"><h2>Printers</h2></div>
</div>
When this feature is activated, the
[[configuration of the printers|doc/sensitive_documents/printing_and_scanning]]
is saved in the persistent volume.
<a id="bitcoin"></a>
<a id="icedove"></a>
<div class="icon">
[[!img electrum.png link=no]]
<div class="text"><h2>Bitcoin Client</h2></div>
[[!img icedove.png link=no]]
<div class="text"><h2>Icedove</h2></div>
</div>
When this feature is activated, the bitcoin wallet and preferences of
the [[*Electrum* bitcoin client|anonymous_internet/electrum]] are saved in the
persistent volume.
When this feature is activated, the configuration and emails stored
by the
[[<span class="application">Icedove</span> email client|doc/anonymous_internet/icedove]]
are saved in the persistent volume.
<a id="dotfiles"></a>
......
#!/bin/sh
# Notes on the Thunderbird directory structure:
# • Mail is stored in mbox format.
# • Folders which contain other folders are named "FolderName.sbd".
# There will also be a corresponding file—which may be empty—called
# "FolderName"
set -eu
OLDIFS=$IFS
IFS="
"
packf="/usr/bin/mh/packf"
ICEDOVE="$HOME/.icedove/profile.default"
SAVEPATH="${ICEDOVE}/Mail/Local Folders"
BACKUPPATH="${ICEDOVE}/Mail/Local Folders Backup $(date +%Y-%m-%d\ %H:%M:%S)"
MAILPATH="$HOME/.claws-mail/Mail"
# Check if Icedove is running
if [ "$(pidof icedove)" ]; then
echo "Icedove seems to be running. Please close Icedove and run this script again." >&2
exit 1
fi
if [ ! -x /usr/bin/mh/packf ]; then
echo "Please install the \"nmh\" package by executing \"sudo apt-get update ; sudo apt-get install nmh\".
Then run this script again." >&2
exit 1
fi
if ! /usr/bin/mh/install-mh -check ; then
/usr/bin/mh/install-mh -auto
fi
# Do not overwrite existing Inbox
if [ -f "$SAVEPATH/Inbox" ]; then
#echo "Existing mailboxes found. Exiting…" >&2
echo "Existing mailboxes found for Icedove. Did you run this script already or have other Icedove mailboxes set up?
Do you want to exit or make a backup of the Icedove mailboxes and copy the Claws Mail mailboxes anyway?
Type [b] to back up the existing Icedove folders or any key to exit."
read confirmbackup
: ${confirmbackup:="n"} # default is to exit
if [ "$confirmbackup" = "b" ]; then
mv $SAVEPATH $BACKUPPATH
else
echo "Exiting…">&2
exit 1
fi
fi
[ -d "$SAVEPATH" ] || mkdir -p "$SAVEPATH"
echo "Saving mailboxes to $SAVEPATH"
cd "$MAILPATH"
for FULLPATH in $(find . -type d)
do
FOLDER="$(basename ${FULLPATH})"
if [ "$(dirname $FULLPATH)" != "." ]; then
DIR="$(dirname $FULLPATH | sed -e 's;^\./;;' -e 's;/;.sbd/;g')"
SBDDIR="$(echo ${DIR}.sbd | sed 's;^\./;;')"
MBOX="$SAVEPATH/$SBDDIR/${FOLDER}"
mkdir -p "$SAVEPATH/$SBDDIR"
else
MBOX="$SAVEPATH/${FOLDER}"
fi
set +u
if [ "$DIR" != "." ]; then
[ ! -f "$SAVEPATH/$DIR" ] || touch "$SAVEPATH/$DIR"
set -u
touch "$MBOX"
# packf will exit nonzero if a folder only contains other folders
yes | $packf +"$FULLPATH" -mbox -file "$MBOX" || true
fi