finds.dev

markshust/docker-magento

Mark Shust's Docker Configuration for Magento

View on GitHubHomepage ↗

★ 2,855ShellMITupdated May 2026

// the take

A Docker Compose setup for local Magento 2 development, maintained by a well-known community figure. It wraps Magento's notoriously painful local setup into a one-liner install with pre-built images for PHP (8.1–8.5), nginx, OpenSearch/Elasticsearch, MariaDB, Redis, and RabbitMQ. Target audience is Magento developers who want a working local environment without spending a day fighting PHP extensions.

The auto-version detection (`bin/detect-versions`) is genuinely useful — it reads your composer.json and pins all service image tags to match your installed Magento version, so you're not manually hunting for compatible combinations. The `compose.override.yaml` pattern for persisting local tweaks across `bin/update` is the right call. Xdebug is now in a dedicated `phpfpm-xdebug` container triggered by cookie, which means you're not toggling a script and restarting FPM every time. The `versions.tsv` lookup table keeping `bin/check-dependencies` and `bin/detect-versions` in sync is a small but solid design choice that prevents drift.

The `bin/` wrapper script collection is a maintenance burden — 60+ shell scripts that are basically one-liners around docker exec, and `bin/xdebug` is now deprecated but still shipped. The `onelinesetup` script pipes curl directly to bash with no checksum verification, which is the kind of thing that will bite someone on a compromised network. There's no support for Magento Cloud (Adobe Commerce on Cloud) local simulation beyond basic compose files, so agencies running cloud projects still need Warden or similar. Windows support is described as 'through WSL' with a separate manual firewall rule step — it works but is clearly a second-class experience with no automated configuration.

We read the README, the directory tree and a key source file in June 2026. Nobody pays to be listed. How we judge →

// at a glance

Stars
2,855
Forks
1,068
Language
Shell
License
MIT
Last commit
21 May 2026

// nearby

If docker-magento isn't quite it.

All repos →