Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/maurosoft1973/docker-alpine-postfix-relay
Postfix Relay Docker image running on Alpine Linux
https://github.com/maurosoft1973/docker-alpine-postfix-relay
alpine alpine-docker docker docker-image docker-postfix postfix
Last synced: about 2 months ago
JSON representation
Postfix Relay Docker image running on Alpine Linux
- Host: GitHub
- URL: https://github.com/maurosoft1973/docker-alpine-postfix-relay
- Owner: maurosoft1973
- License: gpl-2.0
- Created: 2022-10-18T21:10:36.000Z (over 2 years ago)
- Default Branch: master
- Last Pushed: 2023-12-31T17:42:45.000Z (about 1 year ago)
- Last Synced: 2023-12-31T18:29:41.757Z (about 1 year ago)
- Topics: alpine, alpine-docker, docker, docker-image, docker-postfix, postfix
- Language: Shell
- Homepage:
- Size: 53.7 KB
- Stars: 3
- Watchers: 2
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# Postfix Relay Docker image running on Alpine Linux
[](https://hub.docker.com/r/maurosoft1973/alpine-postfix-relay/)
[](https://hub.docker.com/r/maurosoft1973/alpine-postfix-relay/)
[](https://hub.docker.com/r/maurosoft1973/alpine-postfix-relay/)
[](https://alpinelinux.org/)
[](https://www.postfix.net)
This Docker image [(maurosoft1973/alpine-postfix-relay)](https://hub.docker.com/r/maurosoft1973/alpine-postfix-relay/) is based on the minimal [Alpine Linux](https://alpinelinux.org/) with [Postfix Version v3.7.4-r0](https://www.postfix.net).
##### Alpine Version 3.17.2 (Released Feb 10 2023)
##### Postfix Version 3.7.4-r0 (Released 2023-01-23 02:09:53)
----
## 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.17.2``` 3.17.2 branch based (Automatic Architecture Selection)
* ```:3.17.2-aarch64``` 3.17.2 64 bit ARM
* ```:3.17.2-armhf``` 3.17.2 32 bit ARM v6
* ```:3.17.2-armv7``` 3.17.2 32 bit ARM v7
* ```:3.17.2-ppc64le``` 3.17.2 64 bit PowerPC
* ```:3.17.2-x86``` 3.17.2 32 bit Intel/AMD
* ```:3.17.2-x86_64``` 3.17.2 64 bit Intel/AMD
* ```:3.17.2-3.7.4-r0``` 3.17.2-3.7.4-r0 branch based (Automatic Architecture Selection)
* ```:3.17.2-3.7.4-r0-aarch64``` 3.17.2 64 bit ARM
* ```:3.17.2-3.7.4-r0-armhf``` 3.17.2 32 bit ARM v6
* ```:3.17.2-3.7.4-r0-armv7``` 3.17.2 32 bit ARM v7
* ```:3.17.2-3.7.4-r0-ppc64le``` 3.17.2 64 bit PowerPC
* ```:3.17.2-3.7.4-r0-x86``` 3.17.2 32 bit Intel/AMD
* ```:3.17.2-3.7.4-r0-x86_64``` 3.17.2 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
```sh
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
```sh
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](https://myaccount.google.com/apppasswords) for allow send email. The password is automatically generated
Please copy the password and paste into SMTP_GMAIL_PASSWORD
```sh
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.
```pipeline
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 15.02.2023 05:37:14