{"id":22085353,"url":"https://github.com/seieric/postfix-sendgrid-relay-docker","last_synced_at":"2025-07-24T17:31:27.650Z","repository":{"id":185519109,"uuid":"526548027","full_name":"seieric/postfix-sendgrid-relay-docker","owner":"seieric","description":"🐳Dockerized postfix which relays emails to SendGrid. Easy setup with environment variables😃 LDAP compatible!","archived":false,"fork":false,"pushed_at":"2024-07-26T10:12:20.000Z","size":39,"stargazers_count":4,"open_issues_count":0,"forks_count":1,"subscribers_count":1,"default_branch":"main","last_synced_at":"2024-07-26T19:07:33.961Z","etag":null,"topics":["docker","docker-container","docker-image","email-sender","ldap-authentication","mailserver","postfix","postfix-docker","relay-server","saslauthd-ldap","sendgrid-integration"],"latest_commit_sha":null,"homepage":"","language":"Shell","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/seieric.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2022-08-19T09:42:13.000Z","updated_at":"2024-07-26T10:12:24.000Z","dependencies_parsed_at":"2024-07-25T18:31:48.754Z","dependency_job_id":"7d15a8ef-ba82-4ce2-bf05-15abe34dad7f","html_url":"https://github.com/seieric/postfix-sendgrid-relay-docker","commit_stats":null,"previous_names":["seieric/postfix-sendgrid-relay-docker"],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/seieric%2Fpostfix-sendgrid-relay-docker","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/seieric%2Fpostfix-sendgrid-relay-docker/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/seieric%2Fpostfix-sendgrid-relay-docker/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/seieric%2Fpostfix-sendgrid-relay-docker/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/seieric","download_url":"https://codeload.github.com/seieric/postfix-sendgrid-relay-docker/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":227463803,"owners_count":17778465,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["docker","docker-container","docker-image","email-sender","ldap-authentication","mailserver","postfix","postfix-docker","relay-server","saslauthd-ldap","sendgrid-integration"],"created_at":"2024-12-01T01:13:43.183Z","updated_at":"2024-12-01T01:13:44.977Z","avatar_url":"https://github.com/seieric.png","language":"Shell","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Postfix SendGrid relay Docker\n\n🐳Dockerized postfix which relays emails to SendGrid. Just adding some environment variables, you can setup the container.\n\n\u003cb\u003eNote: This image is made for send-only mail server.\u003c/b\u003e\n\n## Features\n- 📩 Realy emails to SendGrid\n- 🔐 SMTP Auth with username and password\n- ✅ SMTP Auth with LDAP\n- 📇 Sender Canonical\n\n## How to use\nJust pull the image and run the container with environment variables. \n\nYou need to provide the hostname of the container to give the postfix hostname, otherwise it uses the container ID as a hostname.\n\nFor example,\n```bash\ndocker run -d --hostname example.com -e SENDGRID_API_KEY=\u003cYOUR_API_KEY\u003e -e SMTP_USER=user -e SMTP_PASSWORD=abcdef -p 25:25 -p 587:587 ghcr.io/seieric/postfix-sendgrid-relay-docker:latest\n```\n\n## Environment variables\n#### SENDGRID_API_KEY (Required)\nYour SENDGRID's API key. The container wouldn't start if not set.\n\n## Environment variables for SMTP AUTH\nIf none of the following variables are set, you can use only port 25.\n### Basic (single account)\nJust create a single account with SMTP_USER and SMTP_PASSWORD.\n#### SMTP_USER (Required)\nUser for SMTP AUTH. If not set, you cannot use submission port 587. Must be used with SMTP_PASSWORD.\n\n#### SMTP_PASSWORD (Required)\nPassword for SMTP AUTH. If not set, you cannot use submission port 587. Must be used with SMTP_USER.\n\n### LDAP authentication\nUse LDAP authentication for SMTP AUTH. You need to set the following variables.\n\n\u003cb\u003eIf you configure LDAP authentication, SMTP_USER and SMTP_PASSWORD will be ignored.\u003c/b\u003e\n\n| Name(* Required)    | Description                                                                 |\n|---------------------|-----------------------------------------------------------------------------|\n| LDAP_SERVER*        | LDAP server address. For example, `ldap://127.0.0.1` or `ldaps://ldap.example.com`. You can set multiple servers. |\n| LDAP_BIND_DN*       | LDAP bind DN.                                                               |\n| LDAP_BIND_PW*       | LDAP bind password.                                                         |\n| LDAP_SEARCH_BASE*   | LDAP search base. For example, `ou=accounts,dc=example,dc=com`.             |\n| LDAP_SEARCH_FILTER  | LDAP search filter. Default is `(\u0026(objectClass=inetOrgPerson)(uid=%U))`.    |\n\n## Feature: sender canonical\nThis image supports sender canonical feature included in postfix.\n\nTo use this feature, just mount your sender canonical file to `/etc/postfix/sender_canonical`\nThe startup script automatically detects the file and enable the feature.","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fseieric%2Fpostfix-sendgrid-relay-docker","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fseieric%2Fpostfix-sendgrid-relay-docker","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fseieric%2Fpostfix-sendgrid-relay-docker/lists"}