{"id":17846471,"url":"https://github.com/technicalguru/docker-mailserver-postfixadmin","last_synced_at":"2025-06-15T19:38:07.171Z","repository":{"id":41840625,"uuid":"249237567","full_name":"technicalguru/docker-mailserver-postfixadmin","owner":"technicalguru","description":"Docker image for postfixadmin in mailserver project","archived":false,"fork":false,"pushed_at":"2025-02-11T09:11:27.000Z","size":781,"stargazers_count":5,"open_issues_count":2,"forks_count":5,"subscribers_count":2,"default_branch":"master","last_synced_at":"2025-02-28T23:46:05.953Z","etag":null,"topics":["email","email-platform","postfix","postfix-docker","postfixadmin","postfixadmin-docker"],"latest_commit_sha":null,"homepage":null,"language":"PHP","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"other","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/technicalguru.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":"CONTRIBUTING.md","funding":null,"license":"LICENSE.md","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":"2020-03-22T17:37:23.000Z","updated_at":"2025-02-11T09:11:30.000Z","dependencies_parsed_at":"2024-10-27T22:28:27.774Z","dependency_job_id":"ffe0e633-f2fa-44fd-b20c-3385f3fef52e","html_url":"https://github.com/technicalguru/docker-mailserver-postfixadmin","commit_stats":null,"previous_names":[],"tags_count":10,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/technicalguru%2Fdocker-mailserver-postfixadmin","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/technicalguru%2Fdocker-mailserver-postfixadmin/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/technicalguru%2Fdocker-mailserver-postfixadmin/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/technicalguru%2Fdocker-mailserver-postfixadmin/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/technicalguru","download_url":"https://codeload.github.com/technicalguru/docker-mailserver-postfixadmin/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":244059425,"owners_count":20391317,"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":["email","email-platform","postfix","postfix-docker","postfixadmin","postfixadmin-docker"],"created_at":"2024-10-27T21:40:01.526Z","updated_at":"2025-06-15T19:38:07.112Z","avatar_url":"https://github.com/technicalguru.png","language":"PHP","funding_links":[],"categories":[],"sub_categories":[],"readme":"# docker-mailserver-postfixadmin\nThis is a Docker image for a PostfixAdmin WebUI. The project is part of the \n[docker-mailserver](https://github.com/technicalguru/docker-mailserver) project but can run separately \nwithout the other components. However, a database server is always required to store structural data. \n\nRelated images:\n* [docker-mailserver](https://github.com/technicalguru/docker-mailserver) - The main project, containing composition instructions\n* [docker-mailserver-postfix](https://github.com/technicalguru/docker-mailserver-postfix) - Postfix/Dovecot image (mailserver component)\n* [docker-mailserver-opendkim](https://github.com/technicalguru/docker-mailserver-opendkim) - OpenDKIM image (DKIM signing milter component)\n* [docker-mailserver-amavis](https://github.com/technicalguru/docker-mailserver-amavis) - Amavis, ClamAV and SpamAssassin (provides spam and virus detection)\n* [docker-mailserver-roundcube](https://github.com/technicalguru/docker-mailserver-roundcube) - Roundcube Webmailer\n\n# Tags\nThe following versions are available from DockerHub. The image tag matches the PostfixAdmin version.\n\n* [3.3.15.1, 3.3.15, 3.3, 3, latest](https://hub.docker.com/repository/docker/technicalguru/mailserver-postfixadmin/tree/v3.3.15.1) - [Dockerfile](https://github.com/technicalguru/docker-mailserver-postfixadmin/blob/3.3.15.1/Dockerfile)\n* [3.2.4-01, 3.2.4, 3.2](https://hub.docker.com/repository/docker/technicalguru/mailserver-postfixadmin/tree/v3.2.4-01) - [Dockerfile](https://github.com/technicalguru/docker-mailserver-postfixadmin/blob/3.2.4-01/Dockerfile)\n\n# Features\n* Database and PostfixAdmin setup from environment variables\n\n# License\n_docker-mailserver-postfixadmin_  is licensed under [GNU LGPL 3.0](LICENSE.md). As with all Docker images, these likely also contain other software which may be under other licenses (such as Bash, etc from the base distribution, along with any direct or indirect dependencies of the primary software being contained).\n\nAs for any pre-built image usage, it is the image user's responsibility to ensure that any use of this image complies with any relevant licenses for all software contained within.\n\n# Prerequisites\nThe following components must be available at runtime:\n* [MySQL \u003e8.0](https://hub.docker.com/\\_/mysql) or [MariaDB \u003e10.4](https://hub.docker.com/\\_/mariadb) - used as database backend for domains and mailboxes. \n\n# Usage\n\n## Environment Variables\n_docker-mailserver-postfixadmin_  requires various environment variables to be set. The container startup will fail when the setup is incomplete.\n\n| **Variable** | **Description** | **Default Value** |\n|------------|---------------|-----------------|\n| `PFA_SETUP_PASS` | The PostfixAdmin setup password. |  |\n| `PFA_DB_HOST` | The hostname or IP address of the database server |  |\n| `PFA_DB_USER` | The name of the database user. **Attention!** You shall not use an administrator account. |  |\n| `PFA_DB_PASS` | The password of the database user |  |\n| `PFA_DB_NAME` | The name of the database | |\n| `PFA_POSTFIX_SERVER` | The hostname of your SMTP server. Postfix requires this to send out initial e-mail for mailboxes. |  |\n| `PFA_ABUSE_EMAIL` | E-mail address to be informed about abuses. |  |\n| `PFA_HOSTMASTER_EMAIL` | E-mail address to be informed about issues with the host image. |  |\n| `PFA_POSTMASTER_EMAIL` | E-mail address to be informed about mailbox and domain issues. |  |\n| `PFA_WEBMASTER_EMAIL` | E-mail address to be informed about issues with the WebUI. |  |\n\n## Ports\n_docker-mailserver-postfixadmin_  exposes port 80 (the WebUI). No TLS support is built in. So you shall put your container behind an Ingress or Reverse Proxy that enforces HTTPS.\n\n## Running the Container\nThe [main mailserver project](https://github.com/technicalguru/docker-mailserver) has examples of container configurations:\n* [with docker-compose](https://github.com/technicalguru/docker-mailserver/tree/master/examples/docker-compose)\n* [with Kubernetes YAML files](https://github.com/technicalguru/docker-mailserver/tree/master/examples/kubernetes)\n* [with HELM charts](https://github.com/technicalguru/docker-mailserver/tree/master/examples/helm-charts)\n\n## Bootstrap and Setup\nOnce you have started your PostfixAdmin container successfully, it is now time to perform the first-time setup for your mailserver. Open the web interface and navigate to `/public/setup.php`.\n\n1. Enter the setup password as you provided it with environment variable `PFA_SETUP_PASS`.\n1. Create your PostfixAdmin administrator account. This is the main account to PostfixAdmin. It will enable you to create domains, mailboxes, aliases, etc.\n1. Login to PostfixAdmin by navigating to `/public/login.php`.\n1. Create your primary domain.\n1. Create your first mailbox in this domain.\n\n# Additional PostfixAdmin customization\nYou can further customize the configuration by placing a `config.site.php` into the `/var/www/html` folder by using a volume mapping.\n\n# Issues\nThis Docker image is mature and supports my own mailserver in production. There are no known issues at the moment.\n\n\n# Contribution\nReport a bug, request an enhancement or pull request at the [GitHub Issue Tracker](https://github.com/technicalguru/docker-mailserver-postfixadmin/issues). Make sure you have checked out the [Contribution Guideline](CONTRIBUTING.md)\n\n\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ftechnicalguru%2Fdocker-mailserver-postfixadmin","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Ftechnicalguru%2Fdocker-mailserver-postfixadmin","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ftechnicalguru%2Fdocker-mailserver-postfixadmin/lists"}