j1cs/postfixadmin repository overview

⁠docker-mailserver-postfixadmin

This is a Docker image for a PostfixAdmin WebUI. The project is part of the docker-mailserver⁠ project but can run separately without the other components. However, a database server is always required to store structural data.

Related images:

• docker-mailserver⁠ - The main project, containing composition instructions
• docker-mailserver-postfix⁠ - Postfix/Dovecot image (mailserver component)
• docker-mailserver-amavis⁠ - Amavis, ClamAV and SpamAssassin (provides spam and virus detection)
• docker-mailserver-roundcube⁠ - Roundcube Webmailer

⁠Tags

The following versions are available from DockerHub. The image tag matches the PostfixAdmin version.

• 3.2.4-01, 3.2.4, 3.2, 3, latest⁠ - Dockerfile⁠

⁠Features

• Database and PostfixAdmin setup from environment variables

⁠License

docker-mailserver-postfixadmin is licensed under GNU LGPL 3.0⁠. 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).

As 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.

⁠Prerequisites

The following components must be available at runtime:

• MySQL >8.0⁠ or MariaDB >10.4⁠ - used as database backend for domains and mailboxes.

⁠Usage

⁠Environment Variables

docker-mailserver-postfixadmin requires various environment variables to be set. The container startup will fail when the setup is incomplete.

⁠Ports

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.

⁠Running the Container

The main mailserver project⁠ has examples of container configurations:

• with docker-compose⁠
• with Kubernetes YAML files⁠
• with HELM charts⁠

⁠Bootstrap and Setup

Once 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.

1. Enter the setup password as you provided it with environment variable PFA_SETUP_PASS.
2. Create your PostfixAdmin administrator account. This is the main account to PostfixAdmin. It will enable you to create domains, mailboxes, aliases, etc.
3. Login to PostfixAdmin by navigating to /public/login.php.
4. Create your primary domain.
5. Create your first mailbox in this domain.

⁠Additional PostfixAdmin customization

You can further customize config.inc.local.php. Please follow these instructions:

1. Get a copy of the file from the /var/www/html folder.
2. Customize your configuration file.
3. Provide your customized file back into the /var/www/html by using a volume mapping.

⁠Issues

This Docker image is mature and supports my own mailserver in production. There are no known issues at the moment.

⁠Contribution

Report a bug, request an enhancement or pull request at the GitHub Issue Tracker⁠. Make sure you have checked out the Contribution Guideline⁠