# Solucionar "Docker.app está dañada y no se puede abrir" en macOS


## Mensaje de error

macOS muestra el siguiente diálogo cuando intentas abrir Docker Desktop:

```text
Docker.app is damaged and can't be opened. You should move it to the Trash.
```

Este error impide que Docker Desktop se inicie y puede ocurrir durante la instalación o después de las actualizaciones.

## Causa posible

Este problema ocurre debido a una copia no atómica durante una instalación por arrastrar y soltar. Cuando arrastras y sueltas `Docker.app` desde un archivo DMG mientras otra aplicación, como VS Code, está invocando la CLI de Docker a través de enlaces simbólicos (symlinks), la operación de copia puede interrumpirse, dejando la aplicación en un estado parcialmente copiado que Gatekeeper marca como "dañada".

## Solución

Sigue estos pasos para resolver el problema:

### Paso uno: Salir de software de terceros

Cierra cualquier aplicación que pueda llamar a Docker en segundo plano:

- Visual Studio Code y otros entornos de desarrollo (IDEs)
- Aplicaciones de terminal
- Aplicaciones de agentes o herramientas de desarrollo
- Cualquier script o proceso que utilice la CLI de Docker

### Paso dos: Eliminar cualquier instalación parcial

1. Mueve `/Applications/Docker.app` a la Papelera y vacía la Papelera.
2. Si usaste un instalador DMG, expulsa y vuelve a montar el DMG de Docker.

### Paso tres: Reinstalar Docker Desktop

Sigue las instrucciones de la [guía de instalación de macOS](/desktop/setup/install/mac-install/) para reinstalar Docker Desktop.

### Si el diálogo persiste

Si sigues viendo el diálogo "dañada" después de seguir los pasos de recuperación:

1. Recopila diagnósticos a través de la terminal. Sigue las instrucciones en [Diagnosticar desde la terminal](/desktop/troubleshoot-and-support/troubleshoot/#diagnosticar-desde-la-terminal).

   - Anota tu ID de diagnóstico que se muestra en la terminal después de ejecutar los diagnósticos.

2. Obtén ayuda:
   - Si tienes una suscripción de pago de Docker, [contacta con soporte](/support/) e incluye tu ID de diagnóstico.
   - Para usuarios de la comunidad, [abre un problema en GitHub](https://github.com/docker/desktop-feedback) e incluye tu ID de diagnóstico.

## Prevención

Para evitar este problema en el futuro:

- Si tu organización lo permite, actualiza Docker Desktop a través del flujo de actualización dentro de la aplicación.
- Sal siempre de las aplicaciones que usan Docker antes de instalar Docker Desktop utilizando el método de arrastrar y soltar del instalador DMG.
- En entornos gestionados, utiliza instalaciones PKG en lugar de arrastrar y soltar desde DMG.
- Mantén montados los volúmenes del instalador hasta que se complete la instalación.

## Información relacionada

- [Instalar Docker Desktop en Mac](/desktop/setup/install/mac-install/)
- [Documentación del instalador PKG](/enterprise/enterprise-deployment/pkg-install-and-configure/)
- [Solucionar problemas de Docker Desktop](/desktop/troubleshoot-and-support/troubleshoot/)
- [Problemas conocidos](/desktop/troubleshoot-and-support/troubleshoot/known-issues/)