From 2617e17fe31c225b1d65e1b07b13bf5501ba6b09 Mon Sep 17 00:00:00 2001 From: Nicolas Marquez Date: Wed, 17 Dec 2025 14:04:37 +0100 Subject: [PATCH] Add cache issues on windows in troubleshooting --- docs/troubleshooting.md | 21 +++++++++++++++++++++ 1 file changed, 21 insertions(+) diff --git a/docs/troubleshooting.md b/docs/troubleshooting.md index 3e59a22b5..f7666e393 100644 --- a/docs/troubleshooting.md +++ b/docs/troubleshooting.md @@ -85,3 +85,24 @@ You can finally start your prod container(s) by running: ```console docker compose -f compose.yaml -f compose.prod.yaml up --wait ``` + +## Cache issues on Windows + +On Windows, Docker Desktop can sometimes cause cache-related issues. To avoid this, it is recommended to use a Linux distribution under WSL (e.g., Ubuntu, Debian) when working with Docker and Symfony. + +Install Ubuntu on WSL + +``` +wsl --install -d Ubuntu +``` + +Install Docker on Ubuntu + +``` +sudo apt update +sudo apt install -y docker.io +sudo systemctl enable --now docker +sudo usermod -aG docker $USER +``` + +Note: Docker Desktop can work as an alternative, but installing Docker natively in Linux is generally faster and avoids cache-related problems. \ No newline at end of file