centersl/docker-docs
1
0
Fork 0
mirror of https://github.com/docker/docs.git synced 2026-03-27 06:18:55 +07:00
Code Issues Packages Projects Releases Wiki Activity

Merge pull request #24420 from dvdksn/fix/issue-24387-compose-standalone-clarity

Browse Source 
compose: clarify standalone install warning with recommended alternatives
This commit is contained in:
David Karlsson
2026-03-19 12:29:57 +01:00
committed by GitHub
parent 36de2705a1 2388e9ea06
commit 6b1ebe4fba
1 changed files with 9 additions and 5 deletions
Download Patch File Download Diff File Expand all files Collapse all files

14
content/manuals/compose/install/standalone.md
View File

@@ -10,13 +10,16 @@ weight: 20
> [!WARNING]
>
> This install scenario is not recommended and is only supported for backward compatibility purposes.
> Use [Docker Desktop](/manuals/desktop/_index.md) or the
> [Docker Compose plugin](/manuals/compose/install/linux.md) instead.
> Use the standalone binary only if you cannot use either of these options.
This page contains instructions on how to install Docker Compose standalone on Linux or Windows Server, from the command line.
> [!WARNING]
>
> The Docker Compose standalone uses the `-compose` syntax instead of the current standard syntax `compose`.
> For example, you must type `docker-compose up` when using Docker Compose standalone, instead of `docker compose up`.
> For example, you must type `docker-compose up` when using Docker Compose standalone, instead of `docker compose up`.
> Use it only for backward compatibility.
## On Linux
@@ -40,6 +43,7 @@ This page contains instructions on how to install Docker Compose standalone on L
> If the command `docker-compose` fails after installation, check your path.
> You can also create a symbolic link to `/usr/bin` or any other directory in your path.
> For example:
>
> ```console
> $ sudo ln -s /usr/local/bin/docker-compose /usr/bin/docker-compose
> ```
@@ -52,14 +56,14 @@ on Microsoft Windows Server](/manuals/engine/install/binaries.md#install-server-
1. Run PowerShell as an administrator.
In order to proceed with the installation, select **Yes** when asked if you want this app to make changes to your device.
2. Optional. Ensure TLS1.2 is enabled.
2. Optional. Ensure TLS1.2 is enabled.
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:
```powershell
[Net.ServicePointManager]::SecurityProtocol = [Net.SecurityProtocolType]::Tls12
```
3. Download the latest release of Docker Compose ({{% param "compose_version" %}}). Run the following command:
3. Download the latest release of Docker Compose ({{% param "compose_version" %}}). Run the following command:
```powershell
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-
> [!NOTE]
>
> On Windows Server 2019 you can add the Compose executable to `$Env:ProgramFiles\Docker`.
Because this directory is registered in the system `PATH`, you can run the `docker-compose --version`
command on the subsequent step with no additional configuration.
> Because this directory is registered in the system `PATH`, you can run the `docker-compose --version`
> command on the subsequent step with no additional configuration.
4. Test the installation.