diff --git a/en_US/howto/relayhost.md b/en_US/howto/relayhost.md new file mode 100644 index 00000000..e0e8553c --- /dev/null +++ b/en_US/howto/relayhost.md @@ -0,0 +1,38 @@ +# Setup relayhost + +Relay host is a server which can accept your email and sent it out to the final +destination for you. + +To setup a global relay host in iRedMail, please append below settings in +Postfix config file `/etc/postfix/main.cf` (Linux/OpenBSD) or +`/usr/local/etc/postfix/main.cf` (FreeBSD): + +```cfg +relayhost = [relay_server]:25 +smtp_sasl_password_maps = hash:/etc/postfix/sasl_password +smtp_sasl_auth_enable = yes +smtp_sasl_mechanism_filter = login +smtp_sasl_security_options = noanonymous +``` + +!!! note + + * You should relace `relay_server` above by the real server address. for + example, `relayhost = [37.61.54.158]:25`, `relayhost = [smtp.gmail.com]:25`. + * For more possible values/formats, please check Postfix document: + [Postfix transport table format (transport)](http://www.postfix.org/transport.5.html). + +Then write the username and password in `/etc/postfix/sasl_password`: + +```cfg +relay.server user:password +``` + +Run `postmap` and restart Postfix service: + +```cmd +postmap hash:/etc/postfix/sasl_password +service postfix restart +``` + +That's it. diff --git a/html/index.html b/html/index.html index 116bf7ad..c50a0731 100644 --- a/html/index.html +++ b/html/index.html @@ -119,6 +119,7 @@
  • Pipe incoming email for certain user to external script
  • How to create and manage public folder
  • Force Dovecot to recalculate mailbox quota
  • +
  • Setup relayhost
  • Reset user password
  • Restrict mail user to login from specified IP addresses or networks
  • Send out email from specified IP address
  • diff --git a/html/relayhost.html b/html/relayhost.html new file mode 100644 index 00000000..010842fa --- /dev/null +++ b/html/relayhost.html @@ -0,0 +1,57 @@ + + + + Setup relayhost + + + + +

    Setup relayhost

    +

    Relay host is a server which can accept your email and sent it out to the final +destination for you.

    +

    To setup a global relay host in iRedMail, please append below settings in +Postfix config file /etc/postfix/main.cf (Linux/OpenBSD) or +/usr/local/etc/postfix/main.cf (FreeBSD):

    +
    relayhost = [relay_server]:25
    +smtp_sasl_password_maps = hash:/etc/postfix/sasl_password
    +smtp_sasl_auth_enable = yes
    +smtp_sasl_mechanism_filter = login
    +smtp_sasl_security_options = noanonymous
    +
    + +
    +

    Note

    + +
    +

    Then write the username and password in /etc/postfix/sasl_password:

    +
    relay.server user:password
    +
    + +

    Run postmap and restart Postfix service:

    +
    postmap hash:/etc/postfix/sasl_password
    +service postfix restart
    +
    + +

    That's it.

    All documents are available in BitBucket repository, and published under Creative Commons license. If you found something wrong, please do contact us to fix it. + \ No newline at end of file