Symfony Docker

A Docker-based installer and runtime for the Symfony web framework, with FrankenPHP and Caddy inside!

Specially tailored for coding agents: ships with a Dev Container configuration that lets Claude Code (and other AI coding assistants) run in fully autonomous mode inside a sandboxed environment.

Getting Started

1. If not already done, install Docker Compose (v2.10+)
2. Run docker compose build --pull --no-cache to build fresh images
3. Run docker compose up --wait to set up and start a fresh Symfony project
4. Open https://localhost in your favorite web browser and accept the auto-generated TLS certificate
5. Run docker compose down --remove-orphans to stop the Docker containers.

Features

• Production, development and CI ready
• Just 1 service by default
• Super-readable configuration
• Blazing-fast performance thanks to the worker mode of FrankenPHP
• Installation of extra Docker Compose services with Symfony Flex
• Automatic HTTPS (in dev and prod)
• HTTP/3 and Early Hints support
• Real-time messaging thanks to a built-in Mercure hub
• Vulcain support
• Native XDebug integration
• Hot Reloading
• Dev Container support, optimized for AI coding agents
• AI coding agents with sandboxing out of the box
• Rootless, slim production image

Enjoy!

Docs

1. Options available
2. Using Symfony Docker with an existing project
3. Support for extra services
4. Deploying in production
5. Debugging with Xdebug
6. TLS Certificates
7. Using MySQL instead of PostgreSQL
8. Using Alpine Linux instead of Debian
9. Using a Makefile
10. Updating the template
11. Troubleshooting
12. Using AI Coding Agents

License

Symfony Docker is available under the MIT License.

Credits

Created by Kévin Dunglas, co-maintained by Maxime Helias and sponsored by Les-Tilleuls.coop.