Skip to content

postfixadmin/docker

Repository files navigation

GitHub CI build status badge

amd64 build status badge arm32v5 build status badge arm32v6 build status badge arm32v7 build status badge arm64v8 build status badge i386 build status badge mips64le build status badge ppc64le build status badge s390x build status badge

Building

  • Clone this repo ( git clone https://github.com/postfixadmin/docker.git docker ) and then run :
  • docker build --pull --rm -t postfixadmin-image <VARIANT> from within the created directory (where <VARIANT> is replaced by apache, fpm or fpm-alpine)

Image Variants

The following variant are currently provided:

apache

This starts an Apache webserver with PHP, so you can use postfixadmin out of the box.

fpm-alpine

This image has a very small footprint. It is based on Alpine Linux and starts only a PHP FPM process. Use this variant if you already have a seperate webserver.

If you need more tools, that are not available on Alpine Linux, use the fpm image instead.

fpm

This image is based on Debian and starts only a PHP FPM container.

Use this variant if you already have a seperate webserver.

Running

Some knowledge of Postfixadmin is assumed.

Advanced users will probably want to specify a custom configuration (config.local.php file).

If you're just trying out the software, there's probably no need for a config.local.php file.

No config.local.php / no existing setup

You have two options :

  • Use a default sqlite database, or
  • Use an external database (MySQL, PgSQL etc).

You can configure this through the following environment variables when running the docker container.

  • POSTFIXADMIN_DB_TYPE=... - sqlite, mysqli, pgsql
  • POSTFIXADMIN_DB_NAME=.... - database name or path to database file (sqlite)
  • POSTFIXADMIN_DB_USER=... - mysqli/pgsql only (db server user name)
  • POSTFIXADMIN_DB_HOST=... - hostname for database, default is localhost.
  • POSTFIXADMIN_DB_PORT=... - port for the database (optional)
  • POSTFIXADMIN_DB_PASSWORD=... - mysqli/pgsql only (db server user password)
  • POSTFIXADMIN_ENCRYPT=... - database password encryption (e.g. md5crypt, SHA512-CRYPT)
  • POSTFIXADMIN_SETUP_PASSWORD=... - generated from setup.php or php -r "echo password_hash('mysecretpassword', PASSWORD_DEFAULT);"

Note: An SQLite database is probably not recommended for production use, but is a quick and easy way to try out the software without dependencies.

Note2: For details about database password encryption please refer to the postfixadmin hashing documentation

You can also set the postfix host and port.

  • POSTFIXADMIN_SMTP_SERVER=... - localhost per default
  • POSTFIXADMIN_SMTP_PORT=... - 25 per default

You can enable DKIM through the following enviroment variables

  • POSTFIXADMIN_DKIM=... - YES/NO
  • POSTFIXADMIN_DKIM_ALL_ADMINS=... - YES/NO

Using Docker secrets

As an alternative to passing sensitive information via environment variables, _FILE may be appended to some of the previously listed environment variables, causing the initialization script to load the values for those variables from files present in the container. In particular, this can be used to load passwords from Docker secrets stored in /run/secrets/<secret_name> files. For example:

docker run -e POSTFIXADMIN_DB_USER_FILE=/run/secrets/postfix-db-user
           -e POSTFIXADMIN_DB_PASSWORD_FILE=/run/secrets/postfix-db-passwd
           -e POSTFIXADMIN_SETUP_PASSWORD_FILE=/run/secrets/postfix-setup-passwd
        postfixadmin

All environment vars are supporting the secret's docker strategy.

Example docker run

docker run -e POSTFIXADMIN_DB_TYPE=mysqli \
           -e POSTFIXADMIN_DB_HOST=whatever \
           -e POSTFIXADMIN_DB_USER=user \
           -e POSTFIXADMIN_DB_PASSWORD=changeme \
           -e POSTFIXADMIN_DB_NAME=postfixadmin \
           -e POSTFIXADMIN_SMTP_SERVER=postfix \
           -e POSTFIXADMIN_SMTP_PORT=25 \
           -e POSTFIXADMIN_ENCRYPT=md5crypt \
           -e POSTFIXADMIN_DKIM=YES \
           -e POSTFIXADMIN_DKIM_ALL_ADMINS=NO \
           --name postfixadmin \
           -p 8080:80 \
        postfixadmin

Existing setup / with config.local.php

Postfixadmin's default configuration is stored in a config.inc.php file (see https://github.com/postfixadmin/postfixadmin/blob/master/config.inc.php ).

To customise, copy this file, remove everything you don't want to override, and call it config.local.php.

docker run -v /local/path/to/config.local.php:/var/www/html/config.local.php \
           --name postfixadmin \
           -p 8080:80 \
           postfixadmin

Next Steps

Once the container is running, try visiting :

Docker Compose

Try something like the below in a docker-compose.yml file; changing the usernames/passwords as required.

Then run : docker-compose up

version: '3'

services:
   db:
     image: mysql:5.7
     restart: always
     environment:
       MYSQL_ROOT_PASSWORD: notSecureChangeMe
       MYSQL_DATABASE: postfixadmin
       MYSQL_USER: postfixadmin
       MYSQL_PASSWORD: postfixadminPassword

   postfixadmin:
     depends_on:
       - db
     image: postfixadmin:latest
     ports:
       - "8000:80"
     restart: always
     environment:
       POSTFIXADMIN_DB_TYPE: mysqli
       POSTFIXADMIN_DB_HOST: db
       POSTFIXADMIN_DB_USER: postfixadmin
       POSTFIXADMIN_DB_NAME: postfixadmin
       POSTFIXADMIN_DB_PASSWORD: postfixadminPassword
       POSTFIXADMIN_SMTP_SERVER: postfix
       POSTFIXADMIN_SMTP_PORT: 25
       POSTFIXADMIN_ENCRYPT: md5crypt