Mautic is distributed under the GPL v3 license. Full details of the license can be found in the Mautic GitHub repository.
Docker-Mautic provides a basic environment for Mautic to run correctly.
Docker images are always simple and functional by design, if you need to add specific features to your Mautic Setup just create a new image based on this official image. You can access and customize Docker Mautic from Official Docker Hub image.
This repository refers to Mautic 3 Series. If you would like information about Mautic 2, see README at 'mautic2.x' folder.
If you want to pull the latest stable image from Mautic 3 Series on DockerHub:
docker pull mautic/mautic:v4
Note that during the 4.0.x period, the 'mautic/mautic:latest' tag still refers to Mautic 2 for backward compatibility. If you intend to use Mautic 2, use the 'mautic/mautic:v2' tag instead of 'mautic/mautic:latest'.
If you want to pull the latest stable image from Mautic 4 Series on DockerHub:
docker pull mautic/mautic:v4
If you want to pull the latest stable image based on Apache2 from Mautic 4 Series on DockerHub:
docker pull mautic/mautic:v4-apache
If you want to pull the latest stable image based on FPM from Mautic 4 Series on DockerHub:
docker pull mautic/mautic:v4-fpm
If you want to pull the latest stable image from Mautic 3 Series on DockerHub:
docker pull mautic/mautic:v3
If you want to pull the latest stable image based on Apache2 from Mautic 3 Series on DockerHub:
docker pull mautic/mautic:v3-apache
If you want to pull the latest stable image based on FPM from Mautic 3 Series on DockerHub:
docker pull mautic/mautic:v3-fpm
Setting up a Network to connect Mautic and MySQL:
$ docker network create mauticnet
Setting up MySQL Server 5.7+ (Percona, MariaDB or MySQL):
$ docker volume create mysql_data
$ docker run --name database -d \
--restart=always \
-p 3306:3306 \
-e MYSQL_ROOT_PASSWORD=mypassword \
-v mysql_data:/var/lib/mysql \
--net=mauticnet \
percona/percona-server:5.7 \
--character-set-server=utf8mb4 --collation-server=utf8mb4_general_ci
Setting Up Mautic:
$ docker volume create mautic_data
$ docker run --name mautic -d \
--restart=always \
-e MAUTIC_DB_HOST=database \
-e MAUTIC_DB_USER=root \
-e MAUTIC_DB_PASSWORD=mypassword \
-e MAUTIC_DB_NAME=mautic \
-e MAUTIC_RUN_CRON_JOBS=true \
-p 8080:80 \
--net=mauticnet \
-v mautic_data:/data \
mautic/mautic:v3
This will run a basic Mautic on http://localhost:8080.
You can build your own containers easily using the docker build command in the root of this directory:
docker build . -f apache/Dockerfile -t mautic/mautic:v4-apache
docker build . -f fpm/Dockerfile -t mautic/mautic:v4-fpm
The following environment variables are also honored for configuring your Mautic instance:
-e MAUTIC_DB_HOST=...(defaults to the IP and port of the linkedmysqlcontainer)-e MAUTIC_DB_USER=...(defaults to "root")-e MAUTIC_DB_PASSWORD=...(defaults to the value of theMYSQL_ROOT_PASSWORDenvironment variable from the linkedmysqlcontainer)-e MAUTIC_DB_NAME=...(defaults to "mautic")-e MAUTIC_DB_TABLE_PREFIX=...(defaults to empty) Add prefix do Mautic Tables. Very useful when migrate existing databases from another server to docker.
If you'd like to use an external database instead of a linked mysql container, specify the hostname and port with MAUTIC_DB_HOST along with the password in MAUTIC_DB_PASSWORD and the username in MAUTIC_DB_USER (if it is something other than root).
If the MAUTIC_DB_NAME specified does not already exist on the given MySQL server, it will be created automatically upon startup of the mautic container, provided that the MAUTIC_DB_USER specified has the necessary permissions to create it.
-e MAUTIC_RUN_CRON_JOBS=...(defaults to true - enabled) If set to true runs mautic cron jobs using included cron daemon-e MAUTIC_TRUSTED_PROXIES=...(defaults to empty) If Mautic sits behind a reverse proxy, you can set a json array of CIDR network addresses here, and mautic will set those addresses as trusted proxies. You can use["0.0.0.0/0"]or See documentation-e MAUTIC_CRON_HUBSPOT=...(defaults to empty) Enables mautic crons for Hubspot CRM integration-e MAUTIC_CRON_SALESFORCE=...(defaults to empty) Enables mautic crons for Salesforce integration-e MAUTIC_CRON_PIPEDRIVE=...(defaults to empty) Enables mautic crons for Pipedrive CRM integration-e MAUTIC_CRON_ZOHO=...(defaults to empty) Enables mautic crons for Zoho CRM integration-e MAUTIC_CRON_SUGARCRM=...(defaults to empty) Enables mautic crons for SugarCRM integration-e MAUTIC_CRON_DYNAMICS=...(defaults to empty) Enables mautic crons for Dynamics CRM integration
-e PHP_INI_DATE_TIMEZONE=...(defaults toUTC) Set PHP timezone-e PHP_MEMORY_LIMIT=...(defaults to256M) Set PHP memory limit-e PHP_MAX_UPLOAD=...(defaults to20M) Set PHP upload max file size-e PHP_MAX_EXECUTION_TIME=...(defaults to300) Set PHP max execution time
-e PHP_INI_DATE_TIMEZONE=...(defaults toUTC) Set PHP timezone-e PHP_MEMORY_LIMIT=...(defaults to256M) Set PHP memory limit-e PHP_MAX_UPLOAD=...(defaults to20M) Set PHP upload max file size-e PHP_MAX_EXECUTION_TIME=...(defaults to300) Set PHP max execution time
Mautic stores the data needed to persisit at /data - You need to attach a volume to this path to persist data.
Mautic Docker has two ENV that you can specify an version do start your new container:
-e MAUTIC_VERSION(Defaults to "3.0.0")-e MAUTIC_SHA1(Defalts to "ed4287367b8484aa146a1fa904b261ab30d9c6e7")
Additional configuration variables can be added to mautic's local config by prepending them with MAUTIC_CONFIG_. This will be re-applied every time the container is re-started, so can be used for external config management of mautic instances.
-e MAUTIC_CONFIG_DEBUG=1Set debug=1 inlocal.php
Access your new Mautic on http://localhost:8080 or http://host-ip:8080 in a browser.
If you change the Site Address of Mautic General Settings tab to HTTPS (behind a reverse proxy), you can use 0.0.0.0/0 as Trusted Proxies to avoid a redirect loop error. See documentation
... via docker-compose
Example docker-compose.yml for mautic:
version: "2"
services:
database:
image: powertic/percona-docker
container_name: database
environment:
MYSQL_ROOT_PASSWORD: mypassword
ports:
- "3306:3306"
volumes:
- database:/var/lib/mysql
restart: always
networks:
- mauticnet
command: --character-set-server=utf8mb4 --collation-server=utf8mb4_general_ci --sql-mode=""
mautic:
container_name: mautic
image: mautic/mautic:v4-apache
volumes:
- mautic_data:/data
environment:
- MAUTIC_DB_HOST=database
- MAUTIC_DB_USER=root
- MAUTIC_DB_PASSWORD=mypassword
- MAUTIC_DB_NAME=mautic4
restart: always
networks:
- mauticnet
ports:
- "8880:80"Run docker-compose up, wait for it to initialize completely, and visit http://localhost:8080 or http://host-ip:8080.
This compose file was tested on compose file version 3.0+ (docker engine 1.13.0+), see the relation of compose file and docker engine here.
This image is officially supported on Docker version 1.7.1.
Support for older versions (down to 1.0) is provided on a best-effort basis.
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.
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.