ksmtp
=====

**ksmtp** - Simple Python SMTP relay replacement for sendmail with SSL authentication

Useful for relaying all email through an account like Gmail, without the
messy configurations of Postfix / Sendmail.

Source
======

  GitHub - https://github.com/oeey/ksmtp

PyPI
====

  PyPI - https://pypi.python.org/pypi/ksmtp

    pip install ksmtp

Usage
=====

  1. pip install ksmtp

  2. edit /etc/ksmtp.conf with your login credentials

  3. (optional) create symlink to ksmtp to replace sendmail

    ```
    ln -s `which ksmtp` /usr/sbin/sendmail
    ```

  4. send test mail

    ```
    ksmtp test@test.com
    ksmtp test@test.com -s "some subject"
    ```

Code Usage
==========

Sample Python Code:

    import ksmtp
    ksmtp.send(to="test@test.com",
               subject="subject",
               body="some message")

Sample Config
=============

Warning: make sure to backup this configuraiton file!  Python's pip will overwrite it on updates to this package.

/etc/ksmtp.conf:

```
[ksmtp]

## from email address
from = username@gmail.com

## user
user = username@gmail.com

## password
pass = password

## server
server = smtp.gmail.com

## port
port = 465
#port = 587

## secure
secure = ssl
#secure = tls


## default to email address (if none specified)
#to = user@domain.com

## default catch-all (always CC)
#catch-all = user@domain.com

## default subject
#subject = default test subject
```

Issues
======

Gmail:
If you get an "smtplib.SMTPAuthenticationError" and your credentials are
correct, you may need to "allow less secure apps access" to your account.
See https://support.google.com/accounts/answer/6010255



