PHPackages                             thedmsgroup/mautic-eb - PHPackages - PHPackages  [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register)

1. [Directory](/)
2. /
3. [Utility &amp; Helpers](/categories/utility)
4. /
5. thedmsgroup/mautic-eb

ActiveProject[Utility &amp; Helpers](/categories/utility)

thedmsgroup/mautic-eb
=====================

Mautic Open Source Distribution - Modified for scalability

2.15.0(7y ago)107026[7 issues](https://github.com/TheDMSGroup/mautic-eb/issues)GPL-3.0-onlyShellCI failing

Since Dec 15Pushed 5y ago35 watchersCompare

[ Source](https://github.com/TheDMSGroup/mautic-eb)[ Packagist](https://packagist.org/packages/thedmsgroup/mautic-eb)[ RSS](/packages/thedmsgroup-mautic-eb/feed)WikiDiscussions dev Synced yesterday

READMEChangelog (7)Dependencies (4)Versions (12)Used By (0)

Mautic EB [![Latest Stable Version](https://camo.githubusercontent.com/ea23556ce6a982302f26f713ecf61752a3f75efef158f3bcc3a9658ddb69ba65/68747470733a2f2f706f7365722e707567782e6f72672f746865646d7367726f75702f6d61757469632d65622f762f737461626c65)](https://packagist.org/packages/thedmsgroup/mautic-eb) [![Build Status](https://camo.githubusercontent.com/a2462764785c9e98b3c423d596e0dd0f71ab2d2b31f4533380a3e8d3755a851d/68747470733a2f2f7472617669732d63692e636f6d2f546865444d5347726f75702f6d61757469632d65622e7376673f6272616e63683d6d6173746572)](https://travis-ci.com/TheDMSGroup/mautic-eb)
=========================================================================================================================================================================================================================================================================================================================================================================================================================================================================================================================================================================================================

[](#mautic-eb--)

#### Deploy Mautic in a scalable Amazon Elastic Beanstalk cluster.

[](#deploy-mautic-in-a-scalable-amazon-elastic-beanstalk-cluster)

[![Mautic and AWS](https://camo.githubusercontent.com/b96230b5f9706a6e714451736bcec02d159c87ddb8fcb1d1f4940db42f288df6/68747470733a2f2f692e696d6775722e636f6d2f4c6b464e6748722e6a7067 "Mautic and AWS")](https://camo.githubusercontent.com/b96230b5f9706a6e714451736bcec02d159c87ddb8fcb1d1f4940db42f288df6/68747470733a2f2f692e696d6775722e636f6d2f4c6b464e6748722e6a7067)

The goal here is to make it simple and safe to scale Mautic up to millions of leads per week, while maintaining HIPAA &amp; PCI compliance. Other helpful services such as CloudFlare and Newrelic are supported, but optional.

Requirements
------------

[](#requirements)

1. AWS EB environment running PHP 7.1 with environment variables described below
2. AWS RDS MySQL instance (Aurora recommended, preferably encrypted)
3. AWS EFS Volume (used for shared media/spool/etc)
4. Add the AmazonEC2ReadOnlyAccess policy to the aws-elasticbeanstalk-ec2-role (for the cron script to run on leading instance only)
5. We recommend having the Elastic Beanstalk CLI [installed](https://docs.aws.amazon.com/elasticbeanstalk/latest/dg/eb-cli3-install.html) locally.

Elastic Beanstalk Environment Variables
---------------------------------------

[](#elastic-beanstalk-environment-variables)

#### Required:

[](#required)

```
APP_URL               - The default full URL for your site.
DB_HOST               - RDS Host.
DB_HOST_RO            - Optional: RDS Host for read-only slave cluster.
DB_USER               - RDS User.
DB_PASSWD             - RDS Password.
DB_NAME               - RDS Database name.
DB_PORT               - RDS port.
SECRET_KEY            - Hash key for encryption.
MAILER_FROM_NAME      - Default "from" email name.
MAILER_FROM_EMAIL     - Default "from" email address.
EFS_DNS_NAME          - The full DNS of the EFS mount.

```

#### Optional:

[](#optional)

```
REDIS_HOST               - Set to the path of your Redis server/cluster to use Redis for session storage. Helps avoid CSRF errors when scaling. See https://github.com/phpredis/phpredis
MAUTIC_INSTALL           - Set to "1" to initialize mautic for the first/cold deployment only!
MAUTIC_WORKERS           - Number of concurrent campaign trigger workers to run on the leading instance.
                         - Instead of MAUTIC_WORKERS, we reccomend using the following 3 variables now to better control your timing.
MAUTIC_WORKERS_KICKOFF   - Number of concurrent campaign trigger workers running kickoff actions only. Overrides MAUTIC_WORKERS when present.
MAUTIC_WORKERS_SCHEDULED - Number of concurrent campaign trigger workers running scheduled actions only. Overrides MAUTIC_WORKERS when present.
MAUTIC_WORKERS_INACTIVE  - Number of concurrent campaign trigger workers running inactive actions only. Overrides MAUTIC_WORKERS when present.
MAUTIC_WORKERS_SCHEDULED_MID - Optionally sets a minimum contact ID for the scheduled worker group (for performance at large scale).
MAUTIC_WORKERS_KICKOFF_MID   - Optionally sets a minimum contact ID for the kickoff worker group (for performance at large scale).
MAUTIC_WORKERS_INACTIVE_MID  - Optionally sets a minimum contact ID for the inactive worker group (for performance at large scale).
NR_APPNAME               - Newrelic application name.
NR_APPID                 - Newrelic application ID number for deployment notifications.
NR_APM_INSTALL_KEY       - NewRelic install key for Application Monitoring.
NR_INF_INSTALL_KEY       - NewRelic install key for Infrastructure.
NR_API_KEY               - NewRelic API key (optional, for Health plugin).
IP_RESTRICT              - Restrict all UI (/s/) access by IP address/range, must also select URI.
IP_RESTRICT_URI          - The URI to which 403 IP Restriction should be sent.

```

### Travis CI Environment Variables

[](#travis-ci-environment-variables)

You will need to set these up if you wish to deploy your fork to an Elastic Beanstalk environment automatically from Travis.

```
AWS_ACCESS_KEY_ID             - From your IAM console (keep hidden).
AWS_SECRET_ACCESS_KEY         - From your IAM console (keep hidden).
AWS_REGION                    - The region to deploy to (us-east-1).
AWS_EB_APP                    - App name to deploy (mautic-eb).
AWS_EB_ENV                    - Elastic beanstalk environment name (mautic-eb-dev).
ELASTIC_BEANSTALK_LABEL       - Label name of the new version (optional).
ELASTIC_BEANSTALK_DESCRIPTION - Description of the new version (optional). Defaults to the last commit message.

```

### Mautic Customizations

[](#mautic-customizations)

File structure in /mautic\_eb will be copied (destructively) into the /mautic folder on composer install or update. For configuration files and other changes that cannot be plugin-based. Similarly you can use /mautic\_custom for customizations that are brand-specific. Third party plugins that use the "mautic-plugin" installer will have their folders symlinked into the correct location.

- mautic\_eb/\* --&gt; mautic/\*
- mautic\_custom/\* --&gt; mautic/\*
- plugins/\* --&gt; mautic/plugins/\*

Custom dependencies can be included in a root composer.custom

### Local setup

[](#local-setup)

Pretty much the same as working with Mautic core:

1. Clone &amp; composer:

```
git clone https://github.com/TheDMSGroup/mautic-eb.git
cd mautic-eb
composer install

```

2. Set up local host at  that points to the `.../mautic-eb/mautic` sub-folder.
3. Browse to  and go through the standard setup.

### Local setup for plugin/mautic-eb development

[](#local-setup-for-pluginmautic-eb-development)

1. Clone &amp; composer:

```
git clone https://github.com/TheDMSGroup/mautic-eb.git
cd mautic-eb
bash ./scripts/build-local.sh

```

2. Set up local host at  that points to the `.../mautic-eb/mautic` sub-folder.
3. Browse to  and go through the standard setup.

### Traditional deployment (from local)

[](#traditional-deployment-from-local)

Should you not wish to use Travis to deploy for you, you can do it manually from your local machine:

- Make sure you've set up the *Requirements* above.
- run `bash ./scripts/build.sh`
- run `eb init` if you haven't already.
- run `eb deploy`

#### Local tips and commands

[](#local-tips-and-commands)

- Important: Do not run `composer install` from within the `./mautic` folder, only in the root project folder.
- `composer cc` to clear all Mautic/Symfony caches.
- `composer custom` to update symlinks for all customizations to mautic core (from mautic\_eb and mautic\_custom).
- `composer less` to compile LESS styles (should you need to extend or modify the core styles using SCSS).
- `composer assets` to regenerate core CSS and JS files for deployment (should you need to modify core JS or SCSS).
- `composer test` to run the full codeception suite.
- The file `composer.custom` can be created for third-party dependencies/plugins/customizations

### Additional Plugins / Customizations

[](#additional-plugins--customizations)

Need to process a million new contacts every day? Need to add a custom integration every day, without writing code?

These are the kinds of requirements we have in Performance Marketing. With that in mind, we include [optional plugins](https://github.com/thedmsgroup?q=mautic&type=public)to augment this build. You can access them all at once by renaming `composer.custom.dev` to `composer.custom` and running `composer install`.

###  Health Score

34

—

LowBetter than 77% of packages

Maintenance19

Infrequent updates — may be unmaintained

Popularity17

Limited adoption so far

Community21

Small or concentrated contributor base

Maturity70

Established project with proven stability

 Bus Factor1

Top contributor holds 53.6% of commits — single point of failure

How is this calculated?**Maintenance (25%)** — Last commit recency, latest release date, and issue-to-star ratio. Uses a 2-year decay window.

**Popularity (30%)** — Total and monthly downloads, GitHub stars, and forks. Logarithmic scaling prevents top-heavy scores.

**Community (15%)** — Contributors, dependents, forks, watchers, and maintainers. Measures real ecosystem engagement.

**Maturity (30%)** — Project age, version count, PHP version support, and release stability.

###  Release Activity

Cadence

Every ~61 days

Total

7

Last Release

2701d ago

### Community

Maintainers

![](https://www.gravatar.com/avatar/b15544847e51ae947aff8bfac6c178fd1337913b3ab871412c0f58733ae1df89?d=identicon)[heathdutton](/maintainers/heathdutton)

---

Top Contributors

[![heathdutton](https://avatars.githubusercontent.com/u/302215?v=4)](https://github.com/heathdutton "heathdutton (98 commits)")[![scottshipman](https://avatars.githubusercontent.com/u/3016737?v=4)](https://github.com/scottshipman "scottshipman (59 commits)")[![cykonetic](https://avatars.githubusercontent.com/u/1146442?v=4)](https://github.com/cykonetic "cykonetic (26 commits)")

---

Tags

aws-elastic-beanstalkmarketing-automationmauticphp

### Embed Badge

![Health badge](/badges/thedmsgroup-mautic-eb/health.svg)

```
[![Health](https://phpackages.com/badges/thedmsgroup-mautic-eb/health.svg)](https://phpackages.com/packages/thedmsgroup-mautic-eb)
```

###  Alternatives

[stfalcon/tinymce-bundle

This Bundle integrates TinyMCE WYSIWYG editor into a Symfony2 project.

2692.9M24](/packages/stfalcon-tinymce-bundle)[helgesverre/extractor

AI-Powered Data Extraction for your Laravel application.

22128.0k](/packages/helgesverre-extractor)[spomky-labs/pwa-bundle

Progressive Web App Manifest Generator Bundle for Symfony.

6144.4k1](/packages/spomky-labs-pwa-bundle)[leapt/core-bundle

Symfony LeaptCoreBundle

2529.1k4](/packages/leapt-core-bundle)

PHPackages © 2026

[Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)
