{"id":16362454,"url":"https://github.com/petemcw/ansible-role-postfix","last_synced_at":"2025-10-16T07:44:55.752Z","repository":{"id":14362728,"uuid":"17072526","full_name":"petemcw/ansible-role-postfix","owner":"petemcw","description":"Ansible role for Postfix MTA","archived":false,"fork":false,"pushed_at":"2020-06-28T09:13:32.000Z","size":21,"stargazers_count":37,"open_issues_count":3,"forks_count":40,"subscribers_count":5,"default_branch":"master","last_synced_at":"2025-04-03T15:48:00.969Z","etag":null,"topics":["ansible","ansible-role","mta","postfix"],"latest_commit_sha":null,"homepage":null,"language":null,"has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/petemcw.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null}},"created_at":"2014-02-21T22:47:32.000Z","updated_at":"2024-02-04T03:33:03.000Z","dependencies_parsed_at":"2022-09-21T11:13:53.116Z","dependency_job_id":null,"html_url":"https://github.com/petemcw/ansible-role-postfix","commit_stats":null,"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/petemcw/ansible-role-postfix","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/petemcw%2Fansible-role-postfix","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/petemcw%2Fansible-role-postfix/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/petemcw%2Fansible-role-postfix/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/petemcw%2Fansible-role-postfix/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/petemcw","download_url":"https://codeload.github.com/petemcw/ansible-role-postfix/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/petemcw%2Fansible-role-postfix/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":279166566,"owners_count":26118046,"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","status":"online","status_checked_at":"2025-10-16T02:00:06.019Z","response_time":53,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"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":["ansible","ansible-role","mta","postfix"],"created_at":"2024-10-11T02:24:17.872Z","updated_at":"2025-10-16T07:44:55.714Z","avatar_url":"https://github.com/petemcw.png","language":null,"funding_links":[],"categories":[],"sub_categories":[],"readme":"# Postfix Role for Ansible\n\nThis role configures [Postfix](http://www.postfix.org/) which is a free and\nopen-source mail transfer agent (MTA) that routes and delivers electronic mail,\nintended as an alternative to the widely used Sendmail MTA.\n\n## Requirements\n\nThis role requires [Ansible](http://www.ansibleworks.com/) version 1.4 or higher\nand the Debian/Ubuntu platform.\n\n## Role Variables\n\nThe variables that can be passed to this role and a brief description about\nthem are as follows:\n\n```yaml\n# The FQDN for the Postfix email server\npostfix_domain: ''\n\n# The receiving email address where root email is forwarded\npostfix_notify_email: false\n\n# The next-hop destination of non-local mail, for SMTP define a FQDN or hostname\npostfix_relayhost: ''\n\n# The default flag for whether to enable SMTP sending\npostfix_use_smtp: false\n\n# The username for SMTP authentication\npostfix_relayhost_user: false\n\n# The password for SMTP authentication\npostfix_relayhost_pass: false\n\n# Don't use mechanisms that permit anonymous authentication.\npostfix_smtp_sasl_security_options: 'noanonymous'\n\n# Enable client-side authentication\n# postfix_smtp_sasl_auth_enable: 'yes'\n\n# SMTP user:pass\n# postfix_smtp_sasl_password_maps: 'static:SMTP_Injection:APIKEY'\n\n# Ensures that the connection to the remote smtp server will be encrypted\n# postfix_smtp_tls_security_level: 'encrypt'\n\n# Header size limitation\n# postfix_header_size_limit: '4096000'\n```\n\n## Examples\n\n1. Install Postfix with the default settings\n\n    ```yaml\n    ---\n    # This playbook installs Postfix email server\n\n    - name: Apply Postfix to mail nodes\n      hosts: all\n      roles:\n        - { role: postfix,\n            postfix_domain: 'example.com',\n            postfix_notify_email: 'janedoe@example.com'\n          }\n    ```\n\n2. Install Postfix and configure to use SMTP relay (Mandrill, MailGun, SendGrid, etc.)\n\n    ```yaml\n    ---\n    # This playbook installs Postfix email server\n\n    - name: Apply Postfix to mail nodes\n      hosts: all\n      roles:\n        - { role: postfix,\n            postfix_domain: 'example.com',\n            postfix_notify_email: 'janedoe@example.com',\n            postfix_use_smtp: true,\n            postfix_relayhost: '[smtp.mandrill.com]',\n            postfix_relayhost_user: 'mandrill_username',\n            postfix_relayhost_pass: 'mandrill_apikey'\n          }\n    ```\n3. Install Postfix and configure to use SMTP relay (Sparkpost)\n\n    ```yaml\n    ---\n    # This playbook installs Postfix email server\n\n    - name: Apply Postfix to mail nodes\n      hosts: all\n      roles:\n        - { role: postfix,\n            postfix_domain: 'example.com',\n            postfix_notify_email: 'mbr@example.com',\n            postfix_use_smtp: true,\n            postfix_relayhost: '[smtp.sparkpostmail.com]:587',\n            postfix_smtp_sasl_auth_enable: 'yes',\n            postfix_smtp_sasl_password_maps: 'static:SMTP_Injection:APIKEY',\n            postfix_smtp_sasl_security_options: 'noanonymous',\n            postfix_smtp_tls_security_level: 'encrypt',\n            postfix_header_size_limit: '4096000'\n          }\n    ```\n\n## Dependencies\n\nNone.\n\n## License\n\nMIT.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fpetemcw%2Fansible-role-postfix","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fpetemcw%2Fansible-role-postfix","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fpetemcw%2Fansible-role-postfix/lists"}