# Instalar el plugin de Docker Compose


Esta página contiene instrucciones sobre cómo instalar el plugin de Docker Compose en Linux desde la línea de comandos.

Para instalar el plugin de Docker Compose en Linux, puedes elegir entre:
- [Configurar el repositorio de Docker en tu sistema Linux](#install-using-the-repository).
- [Instalar de forma manual](#install-the-plugin-manually).

> [!NOTE]
>
> Estas instrucciones asumen que ya tienes instalados Docker Engine y la CLI de Docker, y que ahora deseas instalar el plugin de Docker Compose. 

## Instalar utilizando el repositorio

1. Configura el repositorio. Encuentra las instrucciones específicas para cada distribución en:

    [Ubuntu](/engine/install/ubuntu/#install-using-the-repository) |
    [CentOS](/engine/install/centos/#set-up-the-repository) |
    [Debian](/engine/install/debian/#install-using-the-repository) |
    [Raspberry Pi OS](/engine/install/raspberry-pi-os/#install-using-the-repository) |
    [Fedora](/engine/install/fedora/#set-up-the-repository) |
    [RHEL](/engine/install/rhel/#set-up-the-repository).

2. Actualiza el índice de paquetes e instala la versión más reciente de Docker Compose:

    * Para Ubuntu y Debian, ejecuta:

        ```console
        $ sudo apt-get update
        $ sudo apt-get install docker-compose-plugin
        ```
    * Para distribuciones basadas en RPM, ejecuta:

        ```console
        $ sudo yum update
        $ sudo yum install docker-compose-plugin
        ```

3.  Verifica que Docker Compose se haya instalado correctamente comprobando la versión.

    ```console
    $ docker compose version
    ```

### Actualizar Docker Compose

Para actualizar el plugin de Docker Compose, ejecuta los siguientes comandos:

* Para Ubuntu y Debian, ejecuta:

    ```console
    $ sudo apt-get update
    $ sudo apt-get install docker-compose-plugin
    ```
* Para distribuciones basadas en RPM, ejecuta:

    ```console
    $ sudo yum update
    $ sudo yum install docker-compose-plugin
    ```

## Instalar el plugin manualmente

> [!WARNING]
>
> Las instalaciones manuales no se encuentran sujetas a actualizaciones automáticas. Para un mantenimiento más simple, utiliza el método del repositorio de Docker.

1.  Para descargar e instalar el plugin de la CLI de Docker Compose, ejecuta:

    ```console
    $ DOCKER_CONFIG=${DOCKER_CONFIG:-$HOME/.docker}
    $ mkdir -p $DOCKER_CONFIG/cli-plugins
    $ curl -SL https://github.com/docker/compose/releases/download/v5.1.2/docker-compose-linux-x86_64 -o $DOCKER_CONFIG/cli-plugins/docker-compose
    ```

    Este comando descarga e instala la última versión de Docker Compose para el usuario activo dentro del directorio `$HOME`.

    Para instalar:
    - Docker Compose para _todos los usuarios_ de tu sistema, reemplaza `~/.docker/cli-plugins` por `/usr/local/lib/docker/cli-plugins`.
    - Una versión diferente de Compose, sustituye `v5.1.2` por la versión de Compose que desees utilizar.
    - Para una arquitectura diferente, sustituye `x86_64` por la [arquitectura que desees](https://github.com/docker/compose/releases).   


2. Aplica permisos de ejecución al binario:

    ```console
    $ chmod +x $DOCKER_CONFIG/cli-plugins/docker-compose
    ```
    o, si elegiste instalar Compose para todos los usuarios:

    ```console
    $ sudo chmod +x /usr/local/lib/docker/cli-plugins/docker-compose
    ```

3. Prueba la instalación.

    ```console
    $ docker compose version
    ```

## ¿Qué sigue?

- [Comprender cómo funciona Compose](/compose/intro/compose-application-model/)
- [Probar la guía de inicio rápido](/compose/gettingstarted/)