Guides and templates for running Symfony applications locally across macOS, Linux, and Windows.
This repository helps development teams maintain consistency across different operating systems. By adding a Brewfile, Makefile, and docker-compose.yaml to your Symfony project, every team member can set up their local environment with:
make install # Install PHP, Composer, Symfony CLI
make run # Start Docker services and web serverSame commands. Same PHP version. Same services. Any OS.
- Brewfile template - Homebrew dependencies for PHP, Composer, and Symfony CLI
- Makefile template - Common automation commands for installation and running your app
- docker-compose.yaml template - Container services setup (PostgreSQL, RabbitMQ, etc.)
- OS-specific guides - Step-by-step installation instructions for each platform
| OS | Guide | Notes |
|---|---|---|
| macOS | Installation Guide | Uses Homebrew + Docker Desktop/Rancher Desktop |
| Ubuntu/Linux | Installation Guide | Uses Homebrew + Docker Engine |
| Windows 10/11 | Installation Guide | Uses WSL2 + Ubuntu + Docker |
Ready-to-use templates to bootstrap your Symfony project:
- Brewfile - Homebrew dependencies
- Makefile - Automation commands
- docker-compose.yaml - Container services (PostgreSQL, RabbitMQ)
All platforms require:
- Homebrew (package manager)
- Docker or Rancher Desktop (container runtime)
- Git (version control)
your-symfony-project/
├── Brewfile # Homebrew dependencies
├── Makefile # Automation commands
├── docker-compose.yaml # Container services (databases, cache, etc.)
├── composer.json # PHP dependencies
└── ...
This guide is based on information gathered from colleagues across different platforms. Special thanks to:
I can only personally verify the macOS setup, so contributions and troubleshooting help for Linux and Windows (WSL) are especially welcome.
Feel free to open issues or submit pull requests to improve these guides.