2018-08-23 15:36:55 +02:00
# Symfony Docker
2020-12-08 21:26:49 +01:00
A [Docker ](https://www.docker.com/ )-based installer and runtime for the [Symfony ](https://symfony.com ) web framework, with full [HTTP/2 ](https://symfony.com/doc/current/weblink.html ), HTTP/3 and HTTPS support.
2018-08-23 15:36:55 +02:00
2020-10-14 22:44:46 +02:00
2018-08-23 15:36:55 +02:00
## Getting Started
2022-10-17 11:17:15 +02:00
1. If not already done, [install Docker Compose ](https://docs.docker.com/compose/install/ ) (v2.10+)
2023-07-31 14:21:06 +02:00
2. Run `docker compose build --no-cache` to build fresh images
3. Run `docker compose up --pull --wait` to start the project
2021-06-17 17:02:46 +02:00
4. Open `https://localhost` in your favorite web browser and [accept the auto-generated TLS certificate ](https://stackoverflow.com/a/15076602/1352334 )
2022-07-28 19:01:17 +02:00
5. Run `docker compose down --remove-orphans` to stop the Docker containers.
2018-08-23 15:36:55 +02:00
2020-10-19 15:30:43 +02:00
## Features
* Production, development and CI ready
2022-08-04 15:32:22 +02:00
* [Installation of extra Docker Compose services ](docs/extra-services.md ) with Symfony Flex
2020-10-19 15:30:43 +02:00
* Automatic HTTPS (in dev and in prod!)
2020-12-02 00:29:12 +01:00
* HTTP/2, HTTP/3 and [Preload ](https://symfony.com/doc/current/web_link.html ) support
* Built-in [Mercure ](https://symfony.com/doc/current/mercure.html ) hub
* [Vulcain ](https://vulcain.rocks ) support
2022-08-04 15:30:39 +02:00
* Native [XDebug ](docs/xdebug.md ) integration
2020-10-19 15:30:43 +02:00
* Just 2 services (PHP FPM and Caddy server)
* Super-readable configuration
2020-10-16 13:08:20 +02:00
**Enjoy!**
2018-08-23 15:36:55 +02:00
2020-10-16 13:08:20 +02:00
## Docs
2018-08-23 15:36:55 +02:00
2020-10-16 13:08:20 +02:00
1. [Build options ](docs/build.md )
2021-06-18 14:39:55 +02:00
2. [Using Symfony Docker with an existing project ](docs/existing-project.md )
3. [Support for extra services ](docs/extra-services.md )
4. [Deploying in production ](docs/production.md )
2022-08-04 15:30:39 +02:00
5. [Debugging with Xdebug ](docs/xdebug.md )
2021-01-13 12:17:48 +01:00
6. [TLS Certificates ](docs/tls.md )
7. [Using a Makefile ](docs/makefile.md )
8. [Troubleshooting ](docs/troubleshooting.md )
2020-06-11 19:46:15 +02:00
2022-10-18 10:16:42 +02:00
## License
Symfony Docker is available under the MIT License.
2018-08-23 15:36:55 +02:00
## Credits
2019-09-30 23:15:09 +02:00
Created by [Kévin Dunglas ](https://dunglas.fr ), co-maintained by [Maxime Helias ](https://twitter.com/maxhelias ) and sponsored by [Les-Tilleuls.coop ](https://les-tilleuls.coop ).
