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

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
• AI coding agents with an optional network sandbox
• 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.