Mautic on FrankenPHP

Production-ready Docker image for running Mautic on FrankenPHP with a release-driven CI pipeline.

This repository provides:

• a multi-stage Docker build for Mautic
• role-based containers (web / cron / worker)
• production Docker Compose setup
• automated CI that rebuilds images on new Mautic releases

---

🚀 Features

• FrankenPHP runtime (Caddy + PHP in one process)
• Multi-stage build with prebuilt assets
• Non-root runtime
• Role-based containers:
  • mautic_web
  • mautic_cron
  • mautic_worker
• Release-driven CI
  • scheduled builds only when a new Mautic version is released
  • forced rebuilds on infrastructure changes
• Images published to GitHub Container Registry

---

📦 Docker Images

Images are published to:

ghcr.io/mapiiik/mautic-frankenphp

Available tags:

• latest – latest recommended Mautic version (uses the latest supported PHP)
• <mautic-version> – specific Mautic release (e.g. 7.0.1)
• <major>.<minor> – latest patch release within a minor series (e.g. 7.0)
• <major> – latest stable release within a major series (e.g. 7)
• sha-<commit> – infrastructure build reference

---

🐳 Usage (Production)

1. Copy environment template:

cp .env.example .env

2. Adjust database credentials and options.

3. Start the stack:

docker compose -f compose.production.yaml up -d

or

cp compose.production.yaml compose.yaml
docker compose up -d

⚙️ Configuration

Environment variables

• SERVER_NAME (automatic ACME certificates; otherwise self-signed HTTPS)
• DOCKER_MAUTIC_RUN_MIGRATIONS
• DOCKER_MAUTIC_ENABLE_EMAIL_FETCH
• MAUTIC_CONFIG_PARAMETERS (optional, JSON)

The image supports official Mautic configuration via environment variables as an alternative to config/local.php.

🧠 CI Behavior

• Scheduled runs check for new Mautic releases and build images only when needed.
• Pushes to main always trigger a rebuild.
• No repository changes are made by CI.

📄 License

See individual components for their respective licenses.