maurosoft1973/alpine-postfix-relay repository overview

⁠Postfix Relay Docker image running on Alpine Linux

This Docker image (maurosoft1973/alpine-postfix-relay)⁠ is based on the minimal Alpine Linux⁠ with Postfix Version v3.7.2-r0⁠.

⁠Alpine Version 3.16.0 (Released May 23 2022)

⁠Postfix Version 3.7.2-r0 (Released 2022-04-28 09:57:16)

⁠What is Postfix?

Postfix is a free and open-source mail transfer agent (MTA) that routes and delivers electronic mail.

Postfix attempts to be fast, easy to administer, and secure.

⁠Architectures

• :aarch64 - 64 bit ARM
• :armhf - 32 bit ARM v6
• :armv7 - 32 bit ARM v7
• :ppc64le - 64 bit PowerPC
• :x86 - 32 bit Intel/AMD
• :x86_64 - 64 bit Intel/AMD (x86_64/amd64)

⁠Tags

• :latest latest branch based (Automatic Architecture Selection)
• :aarch64 latest 64 bit ARM
• :armhf latest 32 bit ARM v6
• :armv7 latest 32 bit ARM v7
• :ppc64le latest 64 bit PowerPC
• :x86 latest 32 bit Intel/AMD
• :x86_64 latest 64 bit Intel/AMD
• :test test branch based (Automatic Architecture Selection)
• :test-aarch64 test 64 bit ARM
• :test-armhf test 32 bit ARM v6
• :test-armv7 test 32 bit ARM v7
• :test-ppc64le test 64 bit PowerPC
• :test-x86 test 32 bit Intel/AMD
• :test-x86_64 test 64 bit Intel/AMD
• :3.16.0 3.16.0 branch based (Automatic Architecture Selection)
• :3.16.0-aarch64 3.16.0 64 bit ARM
• :3.16.0-armhf 3.16.0 32 bit ARM v6
• :3.16.0-armv7 3.16.0 32 bit ARM v7
• :3.16.0-ppc64le 3.16.0 64 bit PowerPC
• :3.16.0-x86 3.16.0 32 bit Intel/AMD
• :3.16.0-x86_64 3.16.0 64 bit Intel/AMD
• :3.16.0-3.7.2-r0 3.16.0-3.7.2-r0 branch based (Automatic Architecture Selection)
• :3.16.0-3.7.2-r0-aarch64 3.16.0 64 bit ARM
• :3.16.0-3.7.2-r0-armhf 3.16.0 32 bit ARM v6
• :3.16.0-3.7.2-r0-armv7 3.16.0 32 bit ARM v7
• :3.16.0-3.7.2-r0-ppc64le 3.16.0 64 bit PowerPC
• :3.16.0-3.7.2-r0-x86 3.16.0 32 bit Intel/AMD
• :3.16.0-3.7.2-r0-x86_64 3.16.0 64 bit Intel/AMD

⁠Layers & Sizes

Version	Size

⁠Howto use this image?

This image creates containers that allow you to send e-mails via your e-mail address (ex. gmail).

⁠Environment Variables:

⁠Main Postfix Relay parameters:

• LC_ALL: default locale (default en_GB.UTF-8)
• TIMEZONE: default timezone (default Europe/Brussels)
• SMTP_SENDER_NAME: the name displayed in the from header (also from name)
• SMTP_RELAY_HOST: the smtp server will forward mail
• SMTP_RELAY_PORT: the port of relay host
• SMTP_RELAY_LOGIN: user for login the relay host
• SMTP_RELAY_PASSWORD: password for login the relay host
• RECIPIENT_RESTRICTIONS: the recipients address to delivery email (default empty -> all recipient address)
• ACCEPTED_NETWORKS: the address ip authorized to send email (default 192.168.0.0/16 172.17.0.0/16 172.16.0.0/12 10.0.0.0/8)
• SMTP_USE_TLS: Enabling TLS in the Postfix SMTP Client (default no)
• SMTP_TLS_SECURITY_LEVEL: The default SMTP TLS security level for the Postfix SMTP client (default may)
• SMTP_DEBUG_PEER_LIST: For help with troubleshooting, Postfix can increase logging for particular hosts that you might be having problems with. debug_peer_list specifies a list of one or more hosts, domains, or regular expression patterns whose logging should be increased by the degree specified in debug_peer_level (default: 0.0.0.0 -> none)
• SMTP_DEBUG_PEER_LEVEL: debug level (default 3)

⁠Example of use

⁠1. Create a container with account gmail,without 2FA enabled, and it's listen on all network interfaces and port 25

SMTP_GMAIL_LOGIN=youremail
SMTP_GMAIL_PASSWORD=yourpassword

docker run -d -p 0.0.0.0:25:25 \
       --name alpine-postfix-relay-to-gmail \
       -e SMTP_RELAY_HOST=smtp.gmail.com \
       -e SMTP_RELAY_PORT=465 \
       -e SMTP_RELAY_LOGIN=${SMTP_GMAIL_LOGIN} \
       -e SMTP_RELAY_PASSWORD=${SMTP_GMAIL_PASSWORD} \
       maurosoft1973/alpine-postfix-relay

⁠2. Create a container with account gmail,without 2FA enabled, and it's listen on all network interfaces and port 25 and 587

SMTP_GMAIL_LOGIN=youremail
SMTP_GMAIL_PASSWORD=yourpassword

docker run -d -p 0.0.0.0:25:25 -p 0.0.0.0:587:587 \
       --name alpine-postfix-relay-to-gmail \
       -e SMTP_RELAY_HOST=smtp.gmail.com \
       -e SMTP_RELAY_PORT=465 \
       -e SMTP_RELAY_LOGIN=${SMTP_GMAIL_LOGIN} \
       -e SMTP_RELAY_PASSWORD=${SMTP_GMAIL_PASSWORD} \
       maurosoft1973/alpine-postfix-relay

⁠3. Create a container with account gmail,with 2FA enabled, and it's listen on all network interfaces and port 25 and 587

First, you create an account Google apppasswords⁠ for allow send email. The password is automatically generated

Please copy the password and paste into SMTP_GMAIL_PASSWORD

SMTP_GMAIL_LOGIN=youremail
SMTP_GMAIL_PASSWORD=automaticpasswordgenerated

docker run -d -p 0.0.0.0:25:25 -p 0.0.0.0:587:587 \
       --name alpine-postfix-relay-to-gmail \
       -e SMTP_RELAY_HOST=smtp.gmail.com \
       -e SMTP_RELAY_PORT=465 \
       -e SMTP_RELAY_LOGIN=${SMTP_GMAIL_LOGIN} \
       -e SMTP_RELAY_PASSWORD=${SMTP_GMAIL_PASSWORD} \
       maurosoft1973/alpine-postfix-relay

⁠4. Run a service inside GitLab Pipeline Job.Use account gmail,without 2FA enabled.

This job use the image maurosoft1973/alpine-postfix-relay for load as service and send email.

For use, replace the value:

• recipientname
• recipientaddress
• sendername
• youremail
• yourpassword with the your values

Note: i use the sleep function, inside the job, for have time to process the postfix queue, otherwise the e-mail is not sent because the process is stopped.

postfix-relay-service:
    stage: test
    image: maurosoft1973/alpine
    services:
        - name: maurosoft1973/alpine-postfix-relay
          alias: smtp
    variables:
        SMTP_RECIPIENT_NAME: "recipientname"
        SMTP_RECIPIENT: "recipientaddress"
        SMTP_SENDER_NAME: "sendername"
        SMTP_RELAY_HOST: "smtp.gmail.com"
        SMTP_RELAY_PORT: "465"
        SMTP_RELAY_LOGIN: "youremail"
        SMTP_RELAY_PASSWORD: "yourpassword"
    script:
        - apk add curl
        - |
          echo "From: $SMTP_SENDER_NAME <$SMTP_RELAY_LOGIN>" >> mail.txt
          echo "To: $SMTP_RECIPIENT_NAME <${SMTP_RECIPIENT}>" >> mail.txt
          echo "Subject: Test Message - CURL" >> mail.txt
          echo "" >>  mail.txt
          echo "Dear $SMTP_RECIPIENT_NAME," >>  mail.txt
          echo "Test message from GitLab Pipeline" >>  mail.txt
        - curl smtp://smtp -v --mail-from "$SMTP_RELAY_LOGIN" --mail-rcpt "$SMTP_RECIPIENT" -T "mail.txt"
        - sleep 15s

⁠Last Update 24.05.2022 10:30:03