Mautic Docker image and examples

Note

This version refers to Docker images and examples for Mautic 5, previous Mautic versions aren't actively supported anymore. If you would like information about older versions, see https://github.com/mautic/docker-mautic/tree/mautic4.

Important

You might face several issues when using the FPM images, due to the way those are currently implemented. We strongly advise using Apache instead of FPM for the time being. You might face security issues when using the exemplified nginx.conf. Only proceed with FPM if you are familiar with Nginx configuration! Please refer to #317 for updates on this topic.

Versions

All Mautic 5 Docker images follow the following naming stategy.

<major.minor.patch>-<variant>

There are some defaults if parts are omitted:

• <minor.patch> is the latest release patch version in the latest minor version.

Some examples:

• 5-apache: latest stable version of Mautic 5 of the apache variant
• 5.0-fpm: latest version in the 5.0 minor release in the fpm variant
• 5.0.3-apache: specific point release of the apache variant

Variants

The Docker images exist in 2 variants:

• apache: image based on the official php:apache images.
• fpm: image based on the official php:fpm images.

The latest supported Mautic PHP version is used the moment of generating of the image.

Each variant contains:

• the needed dependencies to run Mautic (e.g. PHP modules)
• the Mautic codebase installed via composer (see mautic/recommended-project)
• the needed files and configuration to run as a specific role

See the examples explanation below how you could use them.

Roles

each image can be started in 3 modes:

• mautic_web: runs the Mautic webinterface
• mautic_worker: runs the worker processes to consume the messenger queues
• mautic_cron: runs the defined cronjobs

This allows you to use different scaling strategies to run the workers or crons, without having to maintain separate images.
The mautic_cron and mautic_worker require the codebase anyhow, as they execute console commands that need to bootstrap the full application.

Examples

The examples folder contains examples of docker-compose setups that use the Docker images.

Warning

The examples require docker compose v2.
Running the examples with the unsupported docker-compose v1 will result in a non-starting web container.

Important

Please take into account the purpose of those examples:
it shows how it could be used, not how it should be used.
Do not use those examples in production without reviewing, understanding and configuring them.

• basic: standard example using the apache image with doctrine as async queue.
• fpm-nginx: example using the fpm image in combination with an nginx with doctrine as async queue.
• rabbitmq-worker: example using the apache image with rabbitmq as async queue.

For each example, there are 2 files where settings can be set:

• the .env file: Should be used for all general variables for Mysql, PHP, ...
• the .mautic_env file: Should be used for all Mautic specific variables.

Building your own images

You can build your own images easily using the docker build command in the root of this directory:

docker build . -f apache/Dockerfile -t mautic/mautic:5-apache
docker build . -f fpm/Dockerfile -t mautic/mautic:5-fpm

Persistent storage

The images by default foresee following volumes to persist data (not taking into account e.g. database or queueing data, as that's not part of these images).

• config: the local config folder containing local.php, parameters_local.php, ...
• var/logs: the folder with logs
• docroot/media: the folder with uploaded and generated media files

Configuration and customizing

Configuration

Environment Variables

The following environment variables can be used to configure how your setup should behave.

Mautic Behaviour

• MAUTIC_DB_HOST: IP address or hostname of the MySQL server.
• MAUTIC_DB_PORT: port which the MySQL server is listening on. Defaults to 3306.
• MAUTIC_DB_DATABASE: Database which holds Mautic's tables.
• MAUTIC_DB_USER: MySQL user which should be used by Mautic.
• MAUTIC_DB_PASSWORD: Passowrd of the MySQL user which should be used by Mautic.
• DOCKER_MAUTIC_ROLE: which role does the container has to perform.
  Defaults to mautic_web, other supported values are mautic_worker and mautic_cron.
• DOCKER_MAUTIC_LOAD_TEST_DATA: should the test data be loaded on start or not.
  Defaults to false, other supported value is true.
  This variable is only usable when using the web role.
• DOCKER_MAUTIC_RUN_MIGRATIONS: should the Doctrine migrations be executed on start.
  Defaults to false, other supported value is true.
  This variable is only usable when using the web role.
• DOCKER_MAUTIC_WORKERS_CONSUME_EMAIL: Number of workers to start consuming mails.
  Defaults to 2
• DOCKER_MAUTIC_WORKERS_CONSUME_HIT: Number of workers to start consuming hits.
  Defaults to 2
• DOCKER_MAUTIC_WORKERS_CONSUME_FAILED: Number of workers to start consuming failed e-mails.
  Defaults to 2

PHP Settings

• PHP_INI_VALUE_DATE_TIMEZONE: defaults to UTC
• PHP_INI_VALUE_MEMORY_LIMIT: defaults to 512M
• PHP_INI_VALUE_UPLOAD_MAX_FILESIZE: defaults to 512M
• PHP_INI_VALUE_POST_MAX_FILESIZE: defaults to 512M
• PHP_INI_VALUE_MAX_EXECUTION_TIME: defaults to 300

Mautic settings

Technically, every setting of Mautic you can set via the UI or via the local.php file can be set as environment variable.

e.g. the messenger_dsn_hit can be set via the MAUTIC_MESSENGER_DSN_HIT environment variable.
See the general Mautic documentation for more info.

Customization

Currently this image has no easy way to extend Mautic (e.g. adding extra composer dependencies or installing extra plugins or themes).
This is an ongoing effort we hope to support in an upcoming 5.x release.

For now, please build your own images based on the official ones to add the needed dependencies, plugins and themes.

Day to day tasks

You can execute commands directly against the Mautic CLI. To do so you have two options:

1. Connect to the running container and run the commands.
2. Run the commands as exec via docker (compose).

Both cases will use docker compose exec/docker exec. Using docker compose uses the docker-compose.yaml and the container names listed for ease. More info can be learned about exec commands here.

Note - Two flags that are used commonly in docker Mautic:

1. --user www-data
   • execute as the www-data user, which is the same user as the webserver runs. Running commands as the correct user ensures things function as expected. e.g. file permissions after clearing the cache are correct.
2. --workdir /var/www/html
   • set the working directory to the /var/www/html folder, which is the project root of Mautic.

Connect to the Container

docker compose exec --user www-data --workdir /var/www/html mautic_web /bin/bash

Running a Mautic CLI command

docker compose exec --user www-data --workdir /var/www/html mautic_web php ./bin/console mautic:install https://mautic.example.com --admin_email="[email protected]" --admin_password="Maut1cR0cks!"

Issues

If you have any problems with or questions about this image, please contact us through a GitHub issue.

You can also reach the Mautic community through its online forums or the Mautic Slack channel.

Contributing

You are invited to contribute new features, fixes, or updates, large or small; we are always thrilled to receive pull requests, and do our best to process them as fast as we can.

Before you start to code, we recommend discussing your plans through a GitHub issue, especially for more ambitious contributions. This gives other contributors a chance to point you in the right direction, give you feedback on your design, and help you find out if someone else is working on the same thing.

Contributors ✨

Thanks goes to these wonderful people (emoji key):

Renato 💻 📖 👀

Mauro Chojrin 💻

Matt O'Keefe 💻

This project follows the all-contributors specification. Contributions of any kind welcome!