Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/seieric/postfix-sendgrid-relay-docker
🐳Dockerized postfix which relays emails to SendGrid. Easy setup with environment variables😃 LDAP compatible!
https://github.com/seieric/postfix-sendgrid-relay-docker
docker docker-container docker-image email-sender ldap-authentication mailserver postfix postfix-docker relay-server saslauthd-ldap sendgrid-integration
Last synced: about 2 months ago
JSON representation
🐳Dockerized postfix which relays emails to SendGrid. Easy setup with environment variables😃 LDAP compatible!
- Host: GitHub
- URL: https://github.com/seieric/postfix-sendgrid-relay-docker
- Owner: seieric
- Created: 2022-08-19T09:42:13.000Z (over 2 years ago)
- Default Branch: main
- Last Pushed: 2024-07-26T10:12:20.000Z (6 months ago)
- Last Synced: 2024-07-26T19:07:33.961Z (6 months ago)
- Topics: docker, docker-container, docker-image, email-sender, ldap-authentication, mailserver, postfix, postfix-docker, relay-server, saslauthd-ldap, sendgrid-integration
- Language: Shell
- Homepage:
- Size: 38.1 KB
- Stars: 4
- Watchers: 1
- Forks: 1
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
# Postfix SendGrid relay Docker
🐳Dockerized postfix which relays emails to SendGrid. Just adding some environment variables, you can setup the container.
Note: This image is made for send-only mail server.
## Features
- 📩 Realy emails to SendGrid
- 🔐 SMTP Auth with username and password
- ✅ SMTP Auth with LDAP
- 📇 Sender Canonical
## How to use
Just pull the image and run the container with environment variables.
You need to provide the hostname of the container to give the postfix hostname, otherwise it uses the container ID as a hostname.
For example,
```bash
docker run -d --hostname example.com -e SENDGRID_API_KEY= -e SMTP_USER=user -e SMTP_PASSWORD=abcdef -p 25:25 -p 587:587 ghcr.io/seieric/postfix-sendgrid-relay-docker:latest
```
## Environment variables
#### SENDGRID_API_KEY (Required)
Your SENDGRID's API key. The container wouldn't start if not set.
## Environment variables for SMTP AUTH
If none of the following variables are set, you can use only port 25.
### Basic (single account)
Just create a single account with SMTP_USER and SMTP_PASSWORD.
#### SMTP_USER (Required)
User for SMTP AUTH. If not set, you cannot use submission port 587. Must be used with SMTP_PASSWORD.
#### SMTP_PASSWORD (Required)
Password for SMTP AUTH. If not set, you cannot use submission port 587. Must be used with SMTP_USER.
### LDAP authentication
Use LDAP authentication for SMTP AUTH. You need to set the following variables.
If you configure LDAP authentication, SMTP_USER and SMTP_PASSWORD will be ignored.
| Name(* Required) | Description |
|---------------------|-----------------------------------------------------------------------------|
| LDAP_SERVER* | LDAP server address. For example, `ldap://127.0.0.1` or `ldaps://ldap.example.com`. You can set multiple servers. |
| LDAP_BIND_DN* | LDAP bind DN. |
| LDAP_BIND_PW* | LDAP bind password. |
| LDAP_SEARCH_BASE* | LDAP search base. For example, `ou=accounts,dc=example,dc=com`. |
| LDAP_SEARCH_FILTER | LDAP search filter. Default is `(&(objectClass=inetOrgPerson)(uid=%U))`. |
## Feature: sender canonical
This image supports sender canonical feature included in postfix.
To use this feature, just mount your sender canonical file to `/etc/postfix/sender_canonical`
The startup script automatically detects the file and enable the feature.