https://github.com/bodsch/ansible-postfix
ansible role to install and configure postfix on various linux systems
https://github.com/bodsch/ansible-postfix
ansible automation mta postfix
Last synced: about 1 year ago
JSON representation
ansible role to install and configure postfix on various linux systems
- Host: GitHub
- URL: https://github.com/bodsch/ansible-postfix
- Owner: bodsch
- License: apache-2.0
- Created: 2021-11-16T12:58:54.000Z (over 4 years ago)
- Default Branch: main
- Last Pushed: 2024-08-19T14:54:07.000Z (almost 2 years ago)
- Last Synced: 2024-08-20T12:14:53.834Z (almost 2 years ago)
- Topics: ansible, automation, mta, postfix
- Language: Jinja
- Homepage:
- Size: 250 KB
- Stars: 1
- Watchers: 2
- Forks: 2
- Open Issues: 1
-
Metadata Files:
- Readme: README.md
- Contributing: CONTRIBUTING.md
- License: LICENSE
Awesome Lists containing this project
README
# Ansible Role: `postfix`
Ansible role to install and configure postfix on various linux systems.
---
> I am in the process of transferring this role to a [collection](https://github.com/bodsch/ansible-collection-mail) and will therefore no longer process any issues or merge requests here.
> However, I will include them in the collection!
> **Please be patient until I have completed the work!**
---
[upstream documentation ](http://www.postfix.org/postconf.5.html)
[postfix deprecations](https://www.postfix.org/DEPRECATION_README.html)
[][ci]
[][issues]
[][releases]
[][galaxy]
[ci]: https://github.com/bodsch/ansible-postfix/actions
[issues]: https://github.com/bodsch/ansible-postfix/issues?q=is%3Aopen+is%3Aissue
[releases]: https://github.com/bodsch/ansible-postfix/releases
[galaxy]: https://galaxy.ansible.com/ui/standalone/roles/bodsch/postfix/
## Requirements & Dependencies
Ansible Collections
- [bodsch.core](https://github.com/bodsch/ansible-collection-core)
```bash
ansible-galaxy collection install bodsch.core
```
or
```bash
ansible-galaxy collection install --requirements-file collections.yml
```
### Operating systems
Tested on
* Arch Linux
* ArtixLinux
* Debian based
- Debian 10 / 11 / 12
- Ubuntu 20.04 / 22.04
## configuration
### main.cf
```yaml
postfix_hostname: "{{ ansible_fqdn }}"
postfix_mailname: "{{ ansible_fqdn }}"
postfix_myorigin: "{{ postfix_mailname_file }}"
postfix_delay_warning_time: ''
postfix_compatibility_level: 'auto'
postfix_aliases: []
postfix_mydestinations:
- $myhostname
- "{{ postfix_hostname }}"
- localdomain
- localhost
- localhost.localdomain
postfix_mynetworks:
- 127.0.0.0/8
# /etc/postfix/main.cf
postfix_disable_vrfy_command: true
```
- [alias](docs/alias.md)
- [default](docs/default.md)
- [header](docs/header.md)
- [inet](docs/inet.md)
- [mailbox](docs/mailbox.md)
- [maillog](docs/maillog.md)
- [message](docs/message.md)
- [postscreen](docs/postscreen.md)
- [proxy](docs/proxy.md)
- [queue](docs/queue.md)
- [recipient](docs/recipient.md)
- [reject](docs/reject.md)
- [relay](docs/relay.md)
- [sender](docs/sender.md)
- [smtp](docs/smtp.md)
- [smtpd](docs/smtpd.md)
- [tls](docs/tls.md)
- [transport](docs/transport.md)
- [virtual_backends](docs/virtual_backends.md)
- [virtual](docs/virtual.md)
### master.cf
To manage the `master.cf` via the role, this feature must be explicitly **enabled**:
```yaml
postfix_handle_mastercf: true
```
To learn more about the configuration of `master.cf`, please read the [extended documentation](docs/master.cf.md).
## Contribution
Please read [Contribution](CONTRIBUTING.md)
## Development, Branches (Git Tags)
The `master` Branch is my *Working Horse* includes the "latest, hot shit" and can be complete broken!
If you want to use something stable, please use a [Tagged Version](https://github.com/bodsch/ansible-postfix/tags)!
## Author
- Bodo Schulz
## License
[Apache](LICENSE)
**FREE SOFTWARE, HELL YEAH!**