Actualizado: 2026-07-07

Docker Compose[1] es la herramienta oficial para definir y ejecutar aplicaciones multi-contenedor con Docker. En lugar de arrancar cada contenedor por separado, Docker Compose lee un fichero docker-compose.yml que describe todos los servicios, redes y volúmenes de la aplicación, y los levanta con un único comando. Este artículo explica cómo instalarlo en Ubuntu 20.04 desde el repositorio oficial.

Puntos clave

  • Docker Compose complementa Docker: gestiona aplicaciones formadas por varios contenedores coordinados.

  • La instalación se realiza descargando el binario directamente desde el repositorio de GitHub de Docker.

  • Antes de instalar, consultar la página de releases[2] para instalar la versión más reciente.

  • Docker Compose v2 está integrado como plugin de Docker CLI (docker compose) en instalaciones modernas; la versión standalone (docker-compose) sigue siendo válida para Ubuntu 20.04.

Requisitos previos

Para completar este tutorial necesitas:

Instalar Docker Compose en Ubuntu

Utilizaremos el repositorio oficial de Docker Compose en GitHub[5] para instalar la última versión disponible.

Importante: antes de ejecutar los comandos, consultar la página de releases de Docker Compose[2] y actualizar el valor de VERSION con la versión más reciente disponible.

VERSION=1.27.0
sudo curl -L "https://github.com/docker/compose/releases/download/${VERSION}/docker-compose-$(uname -s)-$(uname -m)" -o /usr/local/bin/docker-compose
sudo chmod +x /usr/local/bin/docker-compose

El primer comando descarga el binario correspondiente a la arquitectura del sistema ($(uname -s) devuelve Linux, $(uname -m) devuelve x86_64 en servidores de 64 bits). El segundo otorga permisos de ejecución.

Logotipo de Docker, plataforma que incluye Docker Compose para orquestación de contenedoresLogotipo de Docker, plataforma que incluye Docker Compose para orquestación de contenedores

Verificar la instalación

Comprobamos que Docker Compose se ha instalado correctamente y está disponible en el sistema:

docker-compose --version

La salida debe mostrar algo similar a docker-compose version 1.27.0, build .... Si el comando no se encuentra, verificar que /usr/local/bin/ está en el PATH del sistema.

Uso básico

Con Docker Compose instalado, el flujo habitual de trabajo es:

  • Crear un fichero docker-compose.yml que defina los servicios de la aplicación.

  • Ejecutar docker-compose up -d para levantar todos los contenedores en modo desacoplado (background).

  • Usar docker-compose ps para ver el estado de los servicios.

  • Detener y eliminar los contenedores con docker-compose down.

Docker Compose es el punto de partida para desplegar stacks completos, como Traefik como proxy inverso con Docker Compose o aplicaciones más complejas con bases de datos, cachés y servicios web coordinados. Si buscas herramientas de observabilidad sobre tus contenedores, consulta el post sobre Pixie para observabilidad en Kubernetes.

Preguntas frecuentes

¿Cuál es la diferencia entre docker-compose y docker compose?

docker-compose (con guion) es el binario standalone en Python de esta guía: la v1, que la propia documentación de Docker[6] ya marca como sin mantenimiento. docker compose (sin guion, como subcomando) es la v2, reescrita en Go e integrada en el CLI de Docker como plugin. Ambas leen el mismo docker-compose.yml y aceptan casi los mismos flags, así que migrar suele ser tan sencillo como cambiar el espacio por el guion en tus scripts.

¿Por qué esta guía instala la v1 si ya no tiene mantenimiento?

Porque en Ubuntu 20.04 sigue habiendo servidores con la v1 ya desplegada o con automatizaciones que dependen del binario standalone, y entender ese camino ayuda a diagnosticar instalaciones antiguas. Para un servidor nuevo, instala directamente el plugin v2 con sudo apt install docker-compose-plugin desde el repositorio oficial de Docker (no el docker-compose de los repos de Ubuntu, que suele ir varias versiones por detrás).

¿Necesito instalar Docker Compose si ya tengo Docker Engine instalado?

Sí. Docker Engine y Docker Compose son paquetes distintos: Engine ejecuta contenedores sueltos, Compose añade la capa de orquestación multi-contenedor a partir de un fichero YAML. Con el paquete docker-ce oficial no viene incluido por defecto; hay que instalarlo aparte, ya sea el binario standalone de este tutorial o el plugin v2.

¿Cómo actualizo Docker Compose a una versión más reciente?

Si usaste el método standalone de este tutorial, repite los mismos dos comandos con el valor de VERSION actualizado: el curl sobrescribe el binario anterior. Si usas el plugin v2 vía apt, un sudo apt update && sudo apt upgrade docker-compose-plugin basta.

¿Qué hago si docker-compose --version no funciona tras la instalación?

Comprueba primero que /usr/local/bin está en tu PATH (echo $PATH). Si el binario existe pero no es ejecutable, revisa que el chmod +x del paso anterior se completó sin errores de permisos (necesitas sudo o pertenecer al grupo con acceso de escritura sobre ese directorio).

Conclusión

Docker Compose simplifica radicalmente la gestión de aplicaciones multi-contenedor: en lugar de lanzar y configurar cada servicio por separado, un único fichero YAML describe toda la arquitectura. Con el binario instalado y los permisos correctos, el entorno está listo para definir stacks completos en minutos, aunque para un despliegue nuevo lo más sensato hoy es empezar directamente por el plugin v2 en lugar del binario standalone de esta guía.

¿Lees en inglés? Versión completa: How to Install Docker Compose on Ubuntu 20.04.

Fuentes

  1. Docker Compose
  2. página de releases
  3. Ubuntu 20.04
  4. ciclo de vida de Ubuntu
  5. repositorio oficial de Docker Compose en GitHub
  6. propia documentación de Docker