clean up block lists
[ghsmtp.git] / README
blob30659d08b85a90d6f492c556bbaf2ed93533d4bd
1 Gene Hightower's SMTP server.
3 A program to receive Internet (RFC 5321) mail.  This is a “personal
4 domain” type program that delivers mail for all addresses to a single
5 user's ~/Maildir.
7 Free software — AGPLv3 with OpenSSL exception.
9 Written using Standard C++ — plus PEGTL, (at one time Ragel, before
10 that Bison), OpenSSL, boost-iostreams, ldns, spf2, regdom, TinyCDB,
11 glog etc.  Compiles with recent GCC and Clang.
13 sudo dnf install \
14   boost-devel \
15   file-devel \
16   fmt-devel \
17   glog-devel \
18   ldns-devel \
19   libasan \
20   libidn2-devel \
21   libopenarc-devel \
22   libopendkim-devel \
23   libopendmarc-devel \
24   libpsl-devel \
25   libspf2-devel \
26   libubsan \
27   libunistring-devel \
28   openssl-devel \
29   tinycdb-devel
31 Run it from (x)inetd or daemontools as a non-root user.  It will
32 accept mail and store it in that user's ~/Maildir.
34 I run it on the Fedora distribution of GNU/Linux/systemd — might also
35 work on other platforms.
37 Support for some useful SMTP extensions:
39 RFC 1870: Message Size Declaration
40 RFC 2920: Command Pipelining
41 RFC 3030: Transmission of Large and Binary MIME Messages
42 RFC 3207: Secure SMTP over Transport Layer Security
43 RFC 3463: Enhanced Mail System Status Codes
44 RFC 6152: 8-bit MIME Transport
45 RFC 6531: Internationalized Email
47 The software works with IPv4 and IPv6, mostly.
49 I wrote this to experiment with and learn about Internet mail.  I do
50 use it as my every day SMTP server for a number of domains.