The project started during a remote Sylius setup — configured entirely over SSH from a phone. The process was repetitive enough to warrant automating, so I put together a DDEV boilerplate. It got shared publicly before I considered it finished, so I released it as an early alpha and iterated from there.

After a year of internal use it reached v1.0.0, with full Sylius 2.x support, a clean structure, and everything I use day-to-day. Version 1.0.1 followed the next day with cross-platform fixes.

What it does

ddev-sylius is a DDEV-based project template for Sylius 2.x. Clone it, run two commands, and you have a working local Sylius instance — no manual configuration of PHP versions, database, or web server.

What's included

Custom DDEV commands bundled with the boilerplate:

  • ddev sylius-install — full Sylius installation from scratch
  • ddev cc — clear caches
  • ddev dist — install dependencies and build assets
  • ddev security-checker — scan for known vulnerabilities
  • ddev backup / ddev database-import / ddev files-import — backup and restore database and media
  • ddev sylius-cleanup — reset all data (useful when re-testing install flows)
  • ddev build-site / ddev rebuild-site — full or partial project rebuild

Tested on Windows 11 with WSL2, macOS (Apple Silicon), and Linux with Docker.

Getting started

git clone https://github.com/holas1337/ddev-sylius my-project
cd my-project
ddev start
ddev sylius-install

That's it. A few minutes later you have a running Sylius storefront with an admin panel, accessible at the DDEV-generated local URL.

What changed in 1.0.1

The day-after release fixed a few things that showed up during cross-platform testing: macOS-specific adjustments for Mutagen and upload directory exclusions, MariaDB upgraded from 11.4 to 11.8, and phpMyAdmin updated to the latest version.

The repository is on GitHub: holas1337/ddev-sylius. Issues and PRs welcome.