.. include:: /urls.rst

.. _l1_mail:

Librem Mail
===========


.. _l1_mail_install:

Install
-------

.. Android collapsible section

.. raw:: html

   <details>
   <summary><a>Android</a></summary>

.. _l1_mail_install_android:

#. Download and install the `Librem Mail <librem_mail_android_>`_ application.
#. Download and install the `OpenKeychain <OpenKeychain_android_>`_ application.
   It must also be installed for encrypted messaging to function.

.. raw:: html

   </details>

.. PureOS desktop collapsible section

.. raw:: html

   <details>
   <summary><a>PureOS desktop</a></summary>

.. _l1_mail_install_pureos_desktop:

#. `Download Thunderbird`_
#. `Download Enigmail`_

.. raw:: html

   </details>


.. _l1_mail_configuration:

Configuration
-------------

Username: `username@librem.one`

Password: *Librem One password*

+----------+-----------------+------+----------+
|          |      Server     | Port | Security |
+==========+=================+======+==========+
|          |                 | 143  | STARTTLS |
+ Incoming + imap.librem.one +------+----------+
|          |                 | 993  | SSL/TLS  |
+----------+-----------------+------+----------+
|          |                 | 587  | STARTTLS |
+ Outgoing + smtp.librem.one +------+----------+
|          |                 | 465  | SSL/TLS  |
+----------+-----------------+------+----------+

.. note::
   The password length limit for SMTP is 127 characters.

.. Android collapsible section

.. raw:: html

   <details>
   <summary><a>Android</a></summary>

.. _l1_mail_configuration_android:

#. Launch **Librem Mail** and enter your info:

   .. image:: /_files/l1/android/mail/LibremMail_01.png
      :scale: 40%
      :alt: Librem Mail 1
      :class: no-scaled-link

#. Tap **Next** and wait until the server info is configured.
#. Enter the name of your account (in our example here: *L1*) and your name (your name will be displayed to people whom you send emails to):

   .. image:: /_files/l1/android/mail/LibremMail_02.png
      :scale: 40%
      :alt: Librem Mail 2
      :class: no-scaled-link

#. Tap on **Done**.
   That's basically everything you need to do!
   You have configured *Librem One* email:

   .. image:: /_files/l1/android/mail/LibremMail_03.png
      :scale: 40%
      :alt: Librem Mail 3
      :class: no-scaled-link

#. To read your emails, proceed to your inbox (tap on the name of your account which is *L1* in our example):

   .. image:: /_files/l1/android/mail/LibremMail_04.png
      :scale: 40%
      :alt: Librem Mail 4
      :class: no-scaled-link

.. raw:: html

   </details>

.. iOS collapsible section

.. raw:: html

   <details>
   <summary><a>iOS</a></summary>

.. _l1_mail_configuration_ios:

.. note::
   You can use the default Mail app for Librem Mail, but there is **no support for PGP encrypted e-mail** and temporary e-mails expire after 30 days.
   With enough support, we will make an iOS client that *anyone* can use.
   See the stretch goals on our `Librem One`_ crowdfunding page!

#. Open ``Mail`` and select ``Other`` at the bottom of the screen. 

   .. image:: /_files/l1/ios/mail/LibremMail_1.png
      :alt: LibremMail_1
      :class: no-scaled-link

#. Fill out the following:

    * **Name**
      The name you want people to see when they receive your email
    * **Email**
      *username*\ @librem.one
    * **Password**
      *Your Librem One account passphrase*
    * **Description**
      Default is Librem.
      This helps differentiate if you have multiple e-mail address setup in Mail

#. Press ``Next``:

   .. image:: /_files/l1/ios/mail/LibremMail_2.png
      :alt: LibremMail_2
      :class: no-scaled-link

#. Scroll down a bit; enter in the following for INCOMING MAIL SERVER:

    * **Host Name**
      ``imap.librem.one``
    * **User Name**
      *username*\ @librem.one
    * **Password**
      *Your Librem One account passphrase*

#. Then proceed to fill out the next section.

   .. image:: /_files/l1/ios/mail/LibremMail_3.png
      :alt: LibremMail_3
      :class: no-scaled-link

#. Under OUTGOING MAIL SERVER, enter in the following:

    * **Host Name**
      ``smtp.librem.one``
    * **User Name**
      *username*\ @librem.one
    * **Password**
      *Your Librem One account passphrase*

#. Press ``Next``:

   .. image:: /_files/l1/ios/mail/LibremMail_4.png
      :alt: LibremMail_4
      :class: no-scaled-link

#. You should now arrive at your new Inbox.
   Feel free to send a test e-mail to a friend or family member.

   .. image:: /_files/l1/ios/mail/LibremMail_5.png
      :alt: LibremMail_5
      :class: no-scaled-link

Librem Mail is now set up and ready to go on your iPhone!

.. raw:: html

   </details>

.. PureOS desktop collapsible section

.. raw:: html

   <details>
   <summary><a>PureOS desktop</a></summary>

.. _l1_mail_configuration_pureos_desktop:

Access your Librem Mail account in PureOS using an email client such as Thunderbird.

#. Open Thunderbird by opening the activities window, searching for Thunderbird and clicking the search result:

   .. image:: /_files/l1/pureos/mail/LibremMail_00.png
      :alt: Open Thunderbird
      :class: no-scaled-link

#. Fill in the following information.
   Leave the option **"Remember Password"** checked so that Thunderbird does not ask for a password everytime it is launched.

    * **Your Name:** *The name you want people to see when they receive your email*
    * **Email Address:** *your_username@librem.one*
    * **Password:** *Librem One account password*

#. Click **"Continue"**.

   .. image:: /_files/l1/pureos/mail/LibremMail_01.png
      :alt: Credentials
      :class: no-scaled-link

#. Next you will be asked to:

    * Fill your the username of your Librem One account
    * Select if you prefer IMAP or POP3

    IMAP stores the original emails remain stored in the server.
    You can access them from different email clients (Desktop, Phone, Tablet).

    POP3 downloads the email to your local Thunderbird instance and deletes them from the server.
    Your emails can only be accessed from your local machine.
    It frees storage space in your email account in the server, but you cannot properly use multiple email clients (Desktop, Phone, Tablet) to access your email.

#. Click **"Done"** after you fill your username and select your options.

   .. image:: /_files/l1/pureos/mail/LibremMail_02.png
      :alt: Final Credentials
      :class: no-scaled-link

#. Librem Mail is now configured in Thunderbird!

.. raw:: html

   </details>


.. _l1_mail_configuration_encryption:

Encryption
~~~~~~~~~~

.. Android collapsible section

.. raw:: html

   <details>
   <summary><a>Android</a></summary>

.. _l1_mail_configuration_encryption_android:

.. note::
   This guide assumes you that encryption keys have not yet been configured.

#. From the inbox, tap **Menu -> Global Settings**:

   .. image:: /_files/l1/android/mail/LibremMail_08.png
      :scale: 40%
      :alt: Librem Mail 8
      :class: no-scaled-link

#. Open *End-to-end encryption* category.
#. Enable **showing unencrypted signatures**:

   .. image:: /_files/l1/android/mail/LibremMail_09.png
      :scale: 40%
      :alt: Librem Mail 9
      :class: no-scaled-link

#. Tap on **OpenPGP support** to enable *OpenKeychain*:

   .. image:: /_files/l1/android/mail/LibremMail_10.png
      :scale: 40%
      :alt: Librem Mail 10
      :class: no-scaled-link

#. Return back to the inbox.
#. Tap **Menu -> Account Settings**:

   .. image:: /_files/l1/android/mail/LibremMail_11.png
      :scale: 40%
      :alt: Librem Mail 11
      :class: no-scaled-link

#. Open the *End-to-end encryption* category.
#. Enable **autocrypt mutual mode**:

   .. image:: /_files/l1/android/mail/LibremMail_12.png
      :scale: 40%
      :alt: Librem Mail 12
      :class: no-scaled-link

#. Tap to configure **end-to-end encryption key**:

   .. image:: /_files/l1/android/mail/LibremMail_13.png
      :scale: 40%
      :alt: Librem Mail 13
      :class: no-scaled-link

#. To configure enryption keys, tap on **This is a new address** and a key will be automatically configured:

   .. image:: /_files/l1/android/mail/LibremMail_14.png
      :scale: 40%
      :alt: Librem Mail 14
      :class: no-scaled-link

   Your key is now configured.

   .. note::
      It is *highly recommended* to add password to the key.
      For this and more options during key creation please refer to the *OpenKeychain* manual.

.. raw:: html

   </details>

.. PureOS desktop collapsible section

.. raw:: html

   <details>
   <summary><a>PureOS desktop</a></summary>

.. _l1_mail_confiuration_encryption_pureos_desktop:

Thunderbird will show you first the **Enigmail** panel which will allow you to setup encryption keys, to be able to use encrypted emails.

* If you do not want to this at this moment ,you can just select **"Configure enigmail later"**, press **"Next"** and do it later anytime, by selecting: menu > addons > Enigmail
* If you wish to set it up immediately, select **"Start setup now"**, press **"Next"** and you can follow the `EFF PGP guide`_.

.. image:: /_files/l1/pureos/mail/LibremMail_03.png
   :alt: enigmail
   :class: no-scaled-link

After that you can start using Thunderbird with your Librem Mail account in Thunderbird.

.. image:: /_files/l1/pureos/mail/LibremMail_04.png
   :alt: enigmail
   :class: no-scaled-link

.. raw:: html

   </details>


.. _l1_mail_compose_email:

Sending email
-------------

.. Android collapsible section

.. raw:: html

   <details>
   <summary><a>Android</a></summary>

.. _l1_mail_compose_email_android:

#. Tap on the compose icon:

   .. image:: /_files/l1/android/mail/LibremMail_15.png
      :scale: 40%
      :alt: Librem Mail 15
      :class: no-scaled-link

#. Enter the destination email address, subject, and email body:

   .. image:: /_files/l1/android/mail/LibremMail_16.png
      :scale: 40%
      :alt: Librem Mail 16
      :class: no-scaled-link

#. Add attachments as necessary by tapping the paperclip icon.
#. If you have configured your key, it would be a good idea to sign your email.
#. Tap **Menu -> Sign-Only** to sign this outgoing email with your key:

   .. image:: /_files/l1/android/mail/LibremMail_17.png
      :scale: 40%
      :alt: Librem Mail 17
      :class: no-scaled-link

   A popup will explain to you what this actually means.
   Blue checkmark will show up to inform you that this email will be signed:

   .. image:: /_files/l1/android/mail/LibremMail_18.png
      :scale: 40%
      :alt: Librem Mail 18
      :class: no-scaled-link

   If you wish to add CC or BCC field, tap the arrow icon (circled in blue).
#. Tap the send icon (circled in red) when you are ready to send your email:

   .. image:: /_files/l1/android/mail/LibremMail_19.png
      :scale: 40%
      :alt: Librem Mail 19
      :class: no-scaled-link

.. raw:: html

   </details>


.. _l1_mail_encryption:

Send encrypted mail
~~~~~~~~~~~~~~~~~~~


.. _l1_mail_share_public_key:

Sharing your public key
^^^^^^^^^^^^^^^^^^^^^^^

.. Android collapsible section

.. raw:: html

   <details>
   <summary><a>Android</a></summary>

.. _l1_mail_share_public_key_android:

For encryption to work, the recipient needs your public GPG key.

#. Launch *OpenKeychain* and open your key:

   .. image:: /_files/l1/android/mail/LibremMail_20.png
      :scale: 40%
      :alt: Librem Mail 20
      :class: no-scaled-link

#. Tap the menu icon:

   .. image:: /_files/l1/android/mail/LibremMail_21.png
      :scale: 40%
      :alt: Librem Mail 21
      :class: no-scaled-link

#. Select **Advanced**:

   .. image:: /_files/l1/android/mail/LibremMail_22.png
      :scale: 40%
      :alt: Librem Mail 22
      :class: no-scaled-link

   If you are certain you wish everyone to be able to use your *public* key, you can publish it a webserver (tap the option in light blue).
   Otherwise, share it to the recipient via email:

   .. image:: /_files/l1/android/mail/LibremMail_23.png
      :scale: 40%
      :alt: Librem Mail 23
      :class: no-scaled-link

#. When you select Librem Mail to share your public key, it will automatically be added to a new email.
   Insert the recipient's email address and tap **Send**:

   .. image:: /_files/l1/android/mail/LibremMail_24.png
      :scale: 40%
      :alt: Librem Mail 24
      :class: no-scaled-link

.. raw:: html

   </details>


.. _l1_mail_tx_rx_encrypted_mail:

Send and receive encrypted email
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^

.. Android collapsible section

.. raw:: html

   <details>
   <summary><a>Android</a></summary>

.. _l1_mail_tx_rx_encrypted_mail_android:

In this example, the recipient received our email with our key attached and imported it to their keychain.
Now they are able to send us encrypted email:

.. image:: /_files/l1/android/mail/LibremMail_25.png
   :scale: 40%
   :alt: Librem Mail 25
   :class: no-scaled-link

#. The green padlock icon informs us that this email is indeed encrypted, and only we can read it.
   Tap the padlock to check this:

   .. image:: /_files/l1/android/mail/LibremMail_26.png
      :scale: 40%
      :alt: Librem Mail 26
      :class: no-scaled-link

#. Let's reply back.
   First we need to import Haruto's key to our keychain:

   .. image:: /_files/l1/android/mail/LibremMail_27.png
      :scale: 40%
      :alt: Librem Mail 27
      :class: no-scaled-link

#. Compose a response:

   .. image:: /_files/l1/android/mail/LibremMail_28.png
      :scale: 40%
      :alt: Librem Mail 28
      :class: no-scaled-link

#. Again, the green padlock icon informs us that this email will be encrypted for Haruto, and only they will be able to decrypt it with their key:

   .. image:: /_files/l1/android/mail/LibremMail_29.png
      :scale: 40%
      :alt: Librem Mail 29
      :class: no-scaled-link

#. Tap send (icon circled in blue) when you finish composing the email.

.. seealso::
   Proceed to Librem Mail and OpenKeychain manuals to see how to fine-tune those apps.

.. raw:: html

   </details>


.. _l1_mail_tips:

Tips
----

.. Android collapsible section

.. raw:: html

   <details>
   <summary><a>Android</a></summary>

.. _l1_mail_tips_android:

Cleaner display
~~~~~~~~~~~~~~~

If you have only one *Librem One* account, you can hide unified inbox.

#. Tap **Menu -> Settings**:

   .. image:: /_files/l1/android/mail/LibremMail_05.png
      :scale: 40%
      :alt: Librem Mail 5
      :class: no-scaled-link

#. Check the **Hide special accounts** option:

   .. image:: /_files/l1/android/mail/LibremMail_06.png
      :scale: 40%
      :alt: Librem Mail 6
      :class: no-scaled-link

   It looks much cleaner now:

   .. image:: /_files/l1/android/mail/LibremMail_07.png
      :scale: 40%
      :alt: Librem Mail 7
      :class: no-scaled-link

.. raw:: html

   </details>


.. _l1_mail_usage_limit:

Usage limits
------------

+-----------------------------+-------+
| Feature                     | Limit |
+=============================+=======+
| Outgoing emails per minute  | 5     |
+-----------------------------+-------+
| Outgoing emails per day     | 100   |
+-----------------------------+-------+
| Recipients per email        | 50    |
+-----------------------------+-------+
| Total upload size per email | 50 MB |
+-----------------------------+-------+