.. _email-settings:

==============
Email Settings
==============

Fleio uses Django underneath and all Django settings related to e-mail can be set
in the `settings.py` file.

Going through the normal Fleio bootstrap process will ask for SMTP configurations and set them accordingly.

Further modification or addition of the e-mail server settings should be done in the `settings.py` file.

To edit settings.py please see :ref:`How to edit settings.py file<edit_settings-py>`.

If your SMTP server doesn't require authentication, the minimum needed configuration for email sending to work is just
one line in `settings.py`:

.. code-block:: python

    EMAIL_HOST = 'server.host.name' # ex: smtp.gmail.com


You can also configure SMTP authentication and other parameters:


.. code-block:: python

    EMAIL_HOST = 'server.host.name' # ex: smtp.gmail.com
    EMAIL_PORT = 587  # or the server PORT if non standard
    EMAIL_HOST_USER = 'smtpUserName'  # a username, usually the e-mail address
    EMAIL_HOST_PASSWORD = 'UserPassword'  # the smtp user password
    EMAIL_USE_TLS = True  # True if TLS should be enabled or False otherwise
    EMAIL_USE_SSL = False  # True if SSL should be enabled or False otherwise


All email settings are explained in the Django documentation: https://docs.djangoproject.com/en/dev/topics/email/

After you update the e-mail settings variables inside `settings.py` you need to restart Fleio and Celery for the changes
to take effect. Exit and press **y** to save the changes and to restart Fleio.

If you have troubles receiving emails sent by Fleio, see :ref:`troubleshoot-email`.

Please note that if you are using Gmail for smtp, you have to enable account access for less secure apps.
Visit the following link to enable access for your account:

 https://myaccount.google.com/lesssecureapps