vbosstech/mautic repository overview

⁠Mautic Digital Marketing Automation on Amazon AWS ECS & Fargate

⁠1. Docker Image

• You can access and customize Docker Mautic from Official Docker Hub image⁠.
• Setup Automated Builds using GitHub⁠ and Docker Hub⁠

⁠2. How to use this Image:

• docker-compose

  git clone https://github.com/vbosstech/docker-mautic.git
  cd docker-mautic/nginx-ssl-mysql
  docker-compose up -d

• Login to the Docker: {dockerid} <== docker container ls -a

  docker exec -it {dockerid} bash

  ## clear the cache: 
  php app/console cache:clear

  ## set the user ownership to www-data again: 
  chown -R www-data:www-data /var/www/html/

• Shutdown the Container & Cleanup

  docker-compose up

  ## Cleanup the old Containers
  docker rm -f $(docker ps -aq)

• ⁠3.6. Using docker-compose⁠

version: "2"

services:

  web_marketing:
    image: vbosstech/mautic
    container_name: web_marketing
    depends_on:
      - database_marketing
    ports:
      - "80:80"
    volumes:
      - mautic_data:/var/www/html
    environment:
      MAUTIC_DB_HOST: database_marketing
      MAUTIC_DB_NAME: marketing
      MAUTIC_DB_USER: marketing
      MAUTIC_DB_PASSWORD: Job4U.io
      MAUTIC_TRUSTED_PROXIES: 0.0.0.0/0

  database_marketing:
    image: mysql:5.6
    container_name: database_marketing
    ports:
      - 3306:3306
    volumes:
      - mautic_db:/var/lib/mysql
    environment:
      MYSQL_ROOT_PASSWORD: MysqlRootPassword
      MYSQL_DATABASE: marketing
      MYSQL_USER: marketing
      MYSQL_PASSWORD: Job4U.io

  nginx:
    image: nginx
    container_name: nginx_marketing
    ports:
      - "443:443"
    volumes:
      - ./nginx.conf:/etc/nginx/conf.d/default.conf
      - sslcerts:/etc/ssl/private
    depends_on:
      - web_marketing
    entrypoint:
      - "bash"
      - "-c"
    command: |
      "if [ ! -f /etc/ssl/private/marketing.crt ]; then
        echo 'ssl certificate missing, installing openssl to create a new one'
        apt-get update && apt-get install openssl -y
        openssl req -x509 -newkey rsa:2048 -sha256 -nodes -keyout /etc/ssl/private/marketing.key -out /etc/ssl/private/marketing.crt -subj '/CN=marketing.local' -days 3650
        echo 'Created new ssl certificate'
      fi
      exec nginx -g 'daemon off;'"

volumes:
  mautic_data:
  mautic_db:  
  sslcerts:	

Run docker-compose up, wait for it to initialize completely, and visit https://marketing.local or https://host-ip.

⁠3. Customize the Container

⁠3.1. Pulling image from Docker Hub

If you want yo pull the latest stable image from DockerHub:

docker pull vbosstech/mautic

There are also another images that fit your needs:

You can use the beta images to test latest beta releases of Mautic with current PHP version.

⁠3.2. Running Basic Container

Setting up MySQL Server:

$ docker volume create mysql_data

$ docker run --name percona -d \
     -p 3306:3306 \
     -e MYSQL_ROOT_PASSWORD=Job4U \
     -v mysql_data:/var/lib/mysql \
     percona/percona-server:5.7 \
     --character-set-server=utf8 --collation-server=utf8_general_ci

Running Mautic:

$ docker volume create marketing_data

$ docker run --name mautic -d \
    --restart=always \
    -e MAUTIC_DB_HOST=127.0.0.1 \
    -e MAUTIC_DB_USER=root \
    -e MAUTIC_DB_PASSWORD=Job4U \
    -e MAUTIC_DB_NAME=mautic \
    -e MAUTIC_RUN_CRON_JOBS=true \
    -e MAUTIC_TRUSTED_PROXIES=0.0.0.0/0 \
    -p 8080:80 \
    -v marketing_data:/var/www/html \
    vbosstech/mautic:latest

This will run a basic mysql service within Mautic on http://localhost:8080⁠.

⁠3.3. Customizing Mautic Container

The following environment variables are also honored for configuring your Mautic instance:

⁠Database Options

• -e MAUTIC_DB_HOST=... (defaults to the IP and port of the linked mysql container)
• -e MAUTIC_DB_USER=... (defaults to "root")
• -e MAUTIC_DB_PASSWORD=... (defaults to the value of the MYSQL_ROOT_PASSWORD environment variable from the linked mysql container)
• -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.

⁠Mautic Options

• -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 it's Mautic behing a reverse proxy you can set a list of comma separated CIDR network addresses it sets those addreses 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

⁠Enable / Disable Features

• -e MAUTIC_TESTER=... (defaults to empty) Enables Mautic Github Pull Tester documentation⁠

⁠PHP options

• -e PHP_INI_DATE_TIMEZONE=... (defaults to UTC) Set PHP timezone
• -e PHP_MEMORY_LIMIT=... (defaults to 256M) Set PHP memory limit
• -e PHP_MAX_UPLOAD=... (defaults to 20M) Set PHP upload max file size
• -e PHP_MAX_EXECUTION_TIME=... (defaults to 300) Set PHP max execution time

⁠Persistent Data Volumes

On first run Mautic is unpacked at /var/www/html. You need to attach a volume on this path to persist data.

⁠Mautic Versioning

Mautic Docker has two ENV that you can specify an version do start your new container:

• -e MAUTIC_VERSION (Defaults to "2.15.0")
• -e MAUTIC_SHA1 (Defalts to "b07bd42bb092cc96785d2541b33700b55f74ece7")

⁠3.5. Accesing the Instance

Access your new Mautic on http://localhost:8080 or http://host-ip:8080 in a browser.