{"id":24055890,"url":"https://github.com/instrumentisto/postfix-docker-image","last_synced_at":"2025-08-27T01:45:06.548Z","repository":{"id":21645459,"uuid":"92496205","full_name":"instrumentisto/postfix-docker-image","owner":"instrumentisto","description":"Postfix MTA Docker image","archived":false,"fork":false,"pushed_at":"2019-07-26T13:17:33.000Z","size":45,"stargazers_count":21,"open_issues_count":4,"forks_count":10,"subscribers_count":3,"default_branch":"master","last_synced_at":"2025-04-22T22:50:13.905Z","etag":null,"topics":["docker-postfix","postfix","postfix-docker"],"latest_commit_sha":null,"homepage":"http://www.postfix.org","language":"PHP","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/instrumentisto.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE.md","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null}},"created_at":"2017-05-26T09:42:59.000Z","updated_at":"2023-10-02T21:31:02.000Z","dependencies_parsed_at":"2022-09-08T02:20:35.668Z","dependency_job_id":null,"html_url":"https://github.com/instrumentisto/postfix-docker-image","commit_stats":null,"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/instrumentisto/postfix-docker-image","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/instrumentisto%2Fpostfix-docker-image","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/instrumentisto%2Fpostfix-docker-image/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/instrumentisto%2Fpostfix-docker-image/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/instrumentisto%2Fpostfix-docker-image/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/instrumentisto","download_url":"https://codeload.github.com/instrumentisto/postfix-docker-image/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/instrumentisto%2Fpostfix-docker-image/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":272277546,"owners_count":24905517,"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-08-26T02:00:07.904Z","response_time":60,"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":["docker-postfix","postfix","postfix-docker"],"created_at":"2025-01-09T04:32:09.940Z","updated_at":"2025-08-27T01:45:06.514Z","avatar_url":"https://github.com/instrumentisto.png","language":"PHP","readme":"Postfix Docker Image\n====================\n\n[![Build Status](https://travis-ci.org/instrumentisto/postfix-docker-image.svg?branch=master)](https://travis-ci.org/instrumentisto/postfix-docker-image) [![Docker Pulls](https://img.shields.io/docker/pulls/instrumentisto/postfix.svg)](https://hub.docker.com/r/instrumentisto/postfix) [![Uses](https://img.shields.io/badge/uses-s6--overlay-blue.svg)][21]\n\n\n\n\n## Supported tags and respective `Dockerfile` links\n\n- `3.1.3`, `3.1`, `3`, `latest` [(debian/Dockerfile)][101]\n- `3.1.3-alpine`, `3.1-alpine`, `3-alpine`, `alpine` [(alpine/Dockerfile)][102]\n\n\n\n\n## What is Postfix?\n\n[Postfix][13] is a free and open-source mail transfer agent (MTA) that routes and delivers electronic mail, intended as an alternative to [Sendmail MTA][12].\n\nIt is [Wietse Venema][10]'s mail server that started life at [IBM research][11] as an alternative to the widely-used [Sendmail][12] program. Now at Google, Wietse continues to support Postfix.\n\nPostfix attempts to be fast, easy to administer, and secure. The outside has a definite Sendmail-ish flavor, but the inside is completely different.\n\n\u003e [www.postfix.org](http://www.postfix.org)\n\n![Postfix Logo](http://www.postfix.org/mysza.gif)\n\n\n\n\n## How to use this image\n\nTo run Postfix just mount your configuration files and start the container: \n```bash\ndocker run -d -p 25:25 -v /my/main.cf:/etc/postfix/main.cf instrumentisto/postfix\n```\n\n\n### Configuration\n\nTo configure Postfix you may use one of the following ways (but __not both at the same time__):\n\n1.  __Drop-in files__.  \n    Put your configuration files (must end with `.cf`) in `/etc/postfix/main.cf.d/` and `/etc/postfix/master.cf.d/` directories. These files will be applied to default Postfix configuration when container starts.\n    \n    ```bash\n    docker run -d -p 25:25 \\\n               -v /my/main.cf:/etc/postfix/main.cf.d/10-custom.cf:ro \\\n               -v /my/master.cf:/etc/postfix/master.cf.d/10-custom.cf:ro \\\n           instrumentisto/postfix\n    ```\n    \n    This way is convenient if you need only few changes to default configuration, or you want to keep different parts of configuration in different files.\n\n2.  Specify __whole configuration__.  \n    Put your configuration files (`main.cf` and `master.cf`) in `/etc/postfix/` directory, so fully replace the default configuration files provided by image.\n    \n    ```bash\n    docker run -d -p 25:25 \\\n               -v /my/main.cf:/etc/postfix/main.cf:ro \\\n               -v /my/master.cf:/etc/postfix/master.cf:ro \\\n           instrumentisto/postfix\n    ```\n    \n    This way is convenient when it's easier to specify the whole configuration at once, rather than reconfigure default options.\n\n#### Default configuration\n\nTo see default Postfix configuration of this Docker image just run:\n```bash\n# for main.cf\ndocker run --rm instrumentisto/postfix postconf\n\n# for master.cf\ndocker run --rm instrumentisto/postfix postconf -M\n```\n\n\n\n\n## Image versions\n\n\n### `X`\n\nLatest version of `X` Postfix major version.\n\n\n### `X.Y`\n\nLatest version of `X.Y` Postfix minor version.\n\n\n### `X.Y.Z`\n\nConcrete `X.Y.Z` version of Postfix.\n\n\n### `alpine`\n\nThis image is based on the popular [Alpine Linux project][1], available in [the alpine official image][2].\nAlpine Linux is much smaller than most distribution base images (~5MB), and thus leads to much slimmer images in general.\n\nThis variant is highly recommended when final image size being as small as possible is desired. The main caveat to note is that it does use [musl libc][4] instead of [glibc and friends][5], so certain software might run into issues depending on the depth of their libc requirements. However, most software doesn't have an issue with this, so this variant is usually a very safe choice. See [this Hacker News comment thread][6] for more discussion of the issues that might arise and some pro/con comparisons of using Alpine-based images.\n\n\n\n\n## Important tips\n\nAs far as Postfix writes its logs only to `syslog`, the `syslogd` process runs inside container as second side-process and is supervised with [`s6` supervisor][20] provided by [`s6-overlay` project][21].\n\n\n### Logs\n\nThe `syslogd` process of this image is configured to write everything to `/dev/stdout`.\n\nTo change this behaviour just mount your own `/etc/syslog.conf` file with desired log rules.\n\n\n### s6-overlay\n\nThis image contains [`s6-overlay`][21] inside. So you may use all the [features it provides][22] if you need to.\n\n\n\n\n## License\n\nPostfix itself is licensed under [IPL-1 license][91].\n\nPostfix Docker image is licensed under [MIT license][92].\n\n\n\n\n## Issues\n\nWe can't notice comments in the DockerHub so don't use them for reporting issue or asking question.\n\nIf you have any problems with or questions about this image, please contact us through a [GitHub issue][3].\n\n\n\n\n\n[1]: http://alpinelinux.org\n[2]: https://hub.docker.com/_/alpine\n[3]: https://github.com/instrumentisto/postfix-docker-image/issues\n[4]: http://www.musl-libc.org\n[5]: http://www.etalabs.net/compare_libcs.html\n[6]: https://news.ycombinator.com/item?id=10782897\n[10]: http://www.porcupine.org/wietse\n[11]: http://www.research.ibm.com\n[12]: http://www.sendmail.org\n[13]: https://en.wikipedia.org/wiki/Postfix_(software)\n[20]: http://skarnet.org/software/s6/overview.html\n[21]: https://github.com/just-containers/s6-overlay\n[22]: https://github.com/just-containers/s6-overlay#usage\n[91]: http://www.postfix.org/IBM-Public-License-1.0.txt\n[92]: https://github.com/instrumentisto/postfix-docker-image/blob/master/LICENSE.md\n[101]: https://github.com/instrumentisto/postfix-docker-image/blob/master/debian/Dockerfile\n[102]: https://github.com/instrumentisto/postfix-docker-image/blob/master/alpine/Dockerfile\n","funding_links":[],"categories":[],"sub_categories":[],"project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Finstrumentisto%2Fpostfix-docker-image","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Finstrumentisto%2Fpostfix-docker-image","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Finstrumentisto%2Fpostfix-docker-image/lists"}