smtp2tg

README

smtp2tg

SMTP 2 Telegram very simple relay.

It's a fork of abandoned ircop/smtp2tg. Contains several improvements that original maintainer may not want to merge. The difference:

• docker container build ghcr.io/paulannekov/smtp2tg
• fresh Go version with go modules
• fallback to email if Telegram API is unavailable
• support of message pinning when email address contains +pin tag
• several refactorings

Building

Building requires go version go1.18.0. You may use older versions, but without any warranty.

Before build, you must instal packages:

go get

And build program:

go build

Running

Copy binary file to /usr/local/bin, or just run from building directory:

./smtp2tg

or

./smtp2tg -c /etc/smtp2tg.toml

If you want to listen 25 port, you need run program as root.

Running Docker container

docker run -v $(pwd)/smtp2tg.toml:/config/smtp2tg.toml:ro --name smtp2tg ghcr.io/paulannekov/smtp2tg:latest

Daemonizing

Unfortunately, golang has some problems with daemonizing: https://github.com/golang/go/issues/227

You can "daemonize" smtp2tg with system tools, like start-stop-daemon

Usage

You need to point valid dns MX-record to ipaddr, on which daemon is listening. Example, if smtp2tg is listening on 1.2.3.4:

$ORIGIN example.com.
...
alert                   A           1.2.3.4
alert                   IN MX 10    alert.example.com.

And then just send email to user@alert.example.com