https://github.com/namshi/docker-smtp

SMTP docker container
https://github.com/namshi/docker-smtp

amazon-ses docker docker-smtp gmail-smtp smtp smtp-server

Last synced: 1 day ago
JSON representation

SMTP docker container

• Host: GitHub
• URL: https://github.com/namshi/docker-smtp
• Owner: namshi
• License: mit
• Created: 2015-09-21T10:54:18.000Z (about 9 years ago)
• Default Branch: master
• Last Pushed: 2022-10-05T21:20:34.000Z (about 2 years ago)
• Last Synced: 2024-08-01T15:58:06.336Z (3 months ago)
• Topics: amazon-ses, docker, docker-smtp, gmail-smtp, smtp, smtp-server
• Language: Shell
• Size: 38.1 KB
• Stars: 548
• Watchers: 24
• Forks: 198
• Open Issues: 33
• Metadata Files:
  • Readme: README.md
  • License: LICENSE

Awesome Lists containing this project

README

        
# Docker-SMTP

[![](https://images.microbadger.com/badges/image/namshi/smtp.svg)](https://microbadger.com/images/namshi/smtp)

This is a SMTP docker container for sending emails. You can also relay emails to gmail and amazon SES.

## Environment variables

The container accepts `RELAY_NETWORKS` environment variable which *MUST* start with `:` e.g `:192.168.0.0/24` or `:192.168.0.0/24:10.0.0.0/16`.

The container accepts `KEY_PATH` and `CERTIFICATE_PATH` environment variable that if provided will enable TLS support. The paths must be to the key and certificate file on a exposed volume. The keys will be copied into the container location.

The container accepts `MAILNAME` environment variable which will set the outgoing mail hostname.

The container also accepts the `PORT` environment variable, to set the port the mail daemon will listen on inside the container. The default port is `25`.

To configure the binding address, you can use `BIND_IP` and `BIND_IP6` environment variables. The default `BIND_IP` is `0.0.0.0`. The default `BIND_IP6` is `::0`.

To disable IPV6 you can set the `DISABLE_IPV6` environment variable to any value.

The container accepts `OTHER_HOSTNAMES` environment variable which will set the list of domains for which this machine should consider itself the final destination.

## Below are scenarios for using this container

### As SMTP Server

You don't need to specify any environment variable to get this up.

### As a Secondary SMTP Server

Specify 'RELAY_DOMAINS' to setup what domains should be accepted to forward to lower distance MX server.

Format is ` :  :  etc`

### As Gmail Relay

You need to set the `GMAIL_USER` and `GMAIL_PASSWORD` to be able to use it.

### As Amazon SES Relay

You need to set the `SES_USER` and `SES_PASSWORD` to be able to use it.


You can override the SES region by setting `SES_REGION` as well.

If you use Google Compute Engine you also should set `SES_PORT` to 2587.

### As generic SMTP Relay

You can also use any generic SMTP server with authentication as smarthost.

You need to set `SMARTHOST_ADDRESS`, `SMARTHOST_PORT` (connection parameters), `SMARTHOST_USER`, `SMARTHOST_PASSWORD` (authentication parameters), and `SMARTHOST_ALIASES`: this is a list of aliases to puth auth data for authentication, semicolon separated.

```

Example:

 * SMARTHOST_ADDRESS=mail.mysmtp.com

 * SMARTHOST_PORT=587

 * SMARTHOST_USER=myuser

 * SMARTHOST_PASSWORD=secret

 * SMARTHOST_ALIASES=*.mysmtp.com

```