Skip to content

Commit 6b1ebe4

Browse files
authored
Merge pull request #24420 from dvdksn/fix/issue-24387-compose-standalone-clarity
compose: clarify standalone install warning with recommended alternatives
2 parents 36de270 + 2388e9e commit 6b1ebe4

File tree

1 file changed

+9
-5
lines changed

1 file changed

+9
-5
lines changed

content/manuals/compose/install/standalone.md

Lines changed: 9 additions & 5 deletions
Original file line numberDiff line numberDiff line change
@@ -10,13 +10,16 @@ weight: 20
1010
> [!WARNING]
1111
>
1212
> This install scenario is not recommended and is only supported for backward compatibility purposes.
13+
> Use [Docker Desktop](/manuals/desktop/_index.md) or the
14+
> [Docker Compose plugin](/manuals/compose/install/linux.md) instead.
15+
> Use the standalone binary only if you cannot use either of these options.
1316
1417
This page contains instructions on how to install Docker Compose standalone on Linux or Windows Server, from the command line.
1518

1619
> [!WARNING]
1720
>
1821
> The Docker Compose standalone uses the `-compose` syntax instead of the current standard syntax `compose`.
19-
> For example, you must type `docker-compose up` when using Docker Compose standalone, instead of `docker compose up`.
22+
> For example, you must type `docker-compose up` when using Docker Compose standalone, instead of `docker compose up`.
2023
> Use it only for backward compatibility.
2124
2225
## On Linux
@@ -40,6 +43,7 @@ This page contains instructions on how to install Docker Compose standalone on L
4043
> If the command `docker-compose` fails after installation, check your path.
4144
> You can also create a symbolic link to `/usr/bin` or any other directory in your path.
4245
> For example:
46+
>
4347
> ```console
4448
> $ sudo ln -s /usr/local/bin/docker-compose /usr/bin/docker-compose
4549
> ```
@@ -52,14 +56,14 @@ on Microsoft Windows Server](/manuals/engine/install/binaries.md#install-server-
5256
1. Run PowerShell as an administrator.
5357
In order to proceed with the installation, select **Yes** when asked if you want this app to make changes to your device.
5458
55-
2. Optional. Ensure TLS1.2 is enabled.
59+
2. Optional. Ensure TLS1.2 is enabled.
5660
GitHub requires TLS1.2 for secure connections. If you’re using an older version of Windows Server, for example 2016, or suspect that TLS1.2 is not enabled, run the following command in PowerShell:
5761
5862
```powershell
5963
[Net.ServicePointManager]::SecurityProtocol = [Net.SecurityProtocolType]::Tls12
6064
```
6165
62-
3. Download the latest release of Docker Compose ({{% param "compose_version" %}}). Run the following command:
66+
3. Download the latest release of Docker Compose ({{% param "compose_version" %}}). Run the following command:
6367
6468
```powershell
6569
Start-BitsTransfer -Source "https://github.com/docker/compose/releases/download/{{% param "compose_version" %}}/docker-compose-windows-x86_64.exe" -Destination $Env:ProgramFiles\Docker\docker-compose.exe
@@ -70,8 +74,8 @@ on Microsoft Windows Server](/manuals/engine/install/binaries.md#install-server-
7074
> [!NOTE]
7175
>
7276
> On Windows Server 2019 you can add the Compose executable to `$Env:ProgramFiles\Docker`.
73-
Because this directory is registered in the system `PATH`, you can run the `docker-compose --version`
74-
command on the subsequent step with no additional configuration.
77+
> Because this directory is registered in the system `PATH`, you can run the `docker-compose --version`
78+
> command on the subsequent step with no additional configuration.
7579
7680
4. Test the installation.
7781

0 commit comments

Comments
 (0)