document workaround for missing docker-compose command after update (#…

…20906) * document workaround for missing docker-compose command after update Signed-off-by: Nicolas De Loof <[email protected]> * Update content/manuals/compose/install/_index.md --------- Signed-off-by: Nicolas De Loof <[email protected]> Co-authored-by: Allie Sadler <[email protected]>
docker · Sep 16, 2024 · 9232229 · 9232229
1 parent 469a4cd
commit 9232229
Showing 1 changed file with 13 additions and 0 deletions.
diff --git a/content/manuals/compose/install/_index.md b/content/manuals/compose/install/_index.md
@@ -30,6 +30,19 @@ Docker Desktop is available on:
 
 If you have already installed Docker Desktop, you can check which version of Compose you have by selecting **About Docker Desktop** from the Docker menu {{< inline-image src="../../desktop/images/whale-x.svg" alt="whale menu" >}}.
 
+> [!NOTE] 
+>
+> After Docker Compose V1 was removed in Docker Desktop version [4.23.0](/desktop/release-notes/#4230) as it had reached end-of-life,
+> the `docker-compose` command now points directly to the Docker Compose V2 binary, running in standalone mode. 
+> If you rely on Docker Desktop auto-update, the symlink might be broken and command unavailable, as the update doesn't ask for administrator password. 
+> 
+> This only affects Mac users. To fix this, either recreate the symlink:
+> ```console
+> $ sudo rm /usr/local/bin/docker-compose
+> $ sudo ln -s /Applications/Docker.app/Contents/Resources/cli-plugins/docker-compose /usr/local/bin/docker-compose
+> ```
+> Or enable [Automatically check configuration](/desktop/settings/) which will detect and fix it for you.
+
 ### Scenario two: Install the Compose plugin
 
 If you already have Docker Engine and Docker CLI installed, you can install the Compose plugin from the command line, by either: