Symfony Docker

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

Coding-agents ready: ships with a Dev Container and a one-page guide to run OpenCode, Claude Code, or any AI coding assistant, against a local or a remote model, with an optional network sandbox.

Getting Started

• If not already done, install Docker Compose (v2.10+)
• Run docker compose build --pull --no-cache to build fresh images
• Run docker compose up --wait to set up and start a fresh Symfony project
• Open https://localhost in your favorite web browser and accept the auto-generated TLS certificate
• 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
• AI coding agents with an optional network sandbox
• Rootless, slim production image

Docs

• Options available
• Using Symfony Docker with an existing project
• Support for extra services
• Deploying in production
• Debugging with Xdebug
• TLS Certificates
• Using MySQL instead of PostgreSQL
• Using Alpine Linux instead of Debian
• Using a Makefile
• Updating the template
• Troubleshooting
• 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.