Instalar Docker Desktop en Windows

Términos de Docker Desktop

El uso comercial de Docker Desktop en empresas más grandes (más de 250 empleados O más de $10 millones de USD en ingresos anuales) requiere una suscripción de pago.

Esta página proporciona enlaces de descarga, requisitos del sistema e instrucciones de instalación paso a paso para Docker Desktop en Windows.

Docker Desktop para Windows - x86_64 Docker Desktop para Windows - x86_64 en Microsoft Store Docker Desktop para Windows - Arm (Early Access)

Para consultar las sumas de comprobación (checksums), consulta las Notas de la versión

Modos de instalación

Docker Desktop admite dos modos de instalación. Se recomienda la instalación por usuario (Beta) para la mayoría de los usuarios. No requiere privilegios de administrador para instalar o actualizar, y el backend de WSL 2 que utiliza cubre las necesidades de la gran mayoría de los usuarios de Docker Desktop.

Para obtener más información, consulta Comprender los requisitos de permisos para Windows.

Requisitos del sistema

Tip

¿Debería usar Hyper-V o WSL?

La funcionalidad de Docker Desktop se mantiene consistente tanto en WSL como en Hyper-V, sin preferencia por ninguna de las dos arquitecturas. Hyper-V y WSL tienen sus propias ventajas y desventajas, dependiendo de tu configuración específica y de tu caso de uso planeado. Ten en cuenta que Hyper-V solo está disponible con la instalación para todos los usuarios. Si instalas Docker Desktop en modo por usuario, WSL 2 es el único backend compatible.

Los contenedores y las imágenes creados con Docker Desktop se comparten entre todas las cuentas de usuario de los equipos donde está instalado. Esto se debe a que todas las cuentas de Windows utilizan la misma VM para crear y ejecutar contenedores. Ten en cuenta que no es posible compartir contenedores e imágenes entre cuentas de usuario al utilizar el backend de WSL 2 de Docker Desktop.

La ejecución de Docker Desktop dentro de una VM de VMware ESXi o Azure está soportada para clientes de Docker Business. Requiere habilitar primero la virtualización anidada en el hipervisor. Para más información, consulta Ejecutar Docker Desktop en un entorno de VM o VDI.

Instalar Docker Desktop en Windows

Instalación interactiva

1. Descarga el instalador utilizando el botón de descarga en la parte superior de la página, o desde las notas de la versión.

2. Haz doble clic en Docker Desktop Installer.exe para iniciar el instalador. El instalador te preguntará qué modo de instalación prefieres. Elegir la opción por usuario realiza la instalación en %LOCALAPPDATA%\Programs\DockerDesktop y no requiere privilegios de administrador. Elegir la opción para todos los usuarios solicitará privilegios elevados.

   Note

   Si deseas cambiar el modo de instalación más adelante, deberás desinstalar y volver a instalar Docker Desktop.

3. Cuando se te solicite, asegúrate de seleccionar o no la opción Use WSL 2 instead of Hyper-V en la página de Configuración según tu elección de backend.

   On systems that support only one backend, Docker Desktop automatically selects the available option.

4. Sigue las instrucciones del asistente de instalación para autorizar el instalador y proceder con la instalación.

5. Cuando la instalación finalice con éxito, selecciona Close para completar el proceso de instalación.

6. Inicia Docker Desktop.

Instalación desde la línea de comandos

Después de descargar Docker Desktop Installer.exe, ejecuta el siguiente comando en una terminal para instalar Docker Desktop en %LOCALAPPDATA%\Programs\DockerDesktop.

Para la instalación por usuario, ejecuta:

$ "Docker Desktop Installer.exe" install --user

Para realizar la instalación para todos los usuarios en la máquina (requiere privilegios de administrador):

$ "Docker Desktop Installer.exe" install

Si utilizas PowerShell, debes ejecutarlo como:

# Per-user installation (no admin required)
Start-Process 'Docker Desktop Installer.exe' -Wait -ArgumentList 'install', '--user'

# All-users installation (run as administrator)
Start-Process 'Docker Desktop Installer.exe' -Wait install

Si utilizas el Símbolo del sistema de Windows (Command Prompt):

# Per-user installation (no admin required)
start /w "" "Docker Desktop Installer.exe" install --user

# All-users installation (run as administrator)
start /w "" "Docker Desktop Installer.exe" install

Si utilizas la instalación para todos los usuarios y tu cuenta de administrador es diferente de tu cuenta de usuario, debes añadir al usuario al grupo docker-users para acceder a las funciones que requieren privilegios más altos, como la creación y gestión de la VM de Hyper-V, o el uso de contenedores de Windows:

$ net localgroup docker-users <user> /add

Consulta la sección de Opciones del instalador para ver qué opciones acepta el comando install.

Note

Si deseas cambiar el modo de instalación más adelante, deberás desinstalar y volver a instalar Docker Desktop.

Iniciar Docker Desktop

Docker Desktop no se inicia automáticamente después de la instalación. Para iniciar Docker Desktop:

1. Busca Docker y selecciona Docker Desktop en los resultados de búsqueda.

2. El menú de Docker ( ) muestra el Acuerdo de Servicio de Suscripción de Docker (Docker Subscription Service Agreement).

   Aquí tienes un resumen de los puntos clave:

   • Docker Desktop es gratuito para pequeñas empresas (menos de 250 empleados Y menos de 10 millones de dólares de ingresos anuales), uso personal, educación y proyectos de código abierto no comerciales.
   • De lo contrario, requiere una suscripción de pago para uso profesional.
   • También se requieren suscripciones de pago para entidades gubernamentales.
   • Las suscripciones Docker Pro, Team y Business incluyen el uso comercial de Docker Desktop.

3. Selecciona Accept para continuar. Docker Desktop se iniciará una vez que aceptes los términos.

   Ten en cuenta que Docker Desktop no se ejecutará si no estás de acuerdo con los términos. Puedes optar por aceptar los términos más adelante abriendo Docker Desktop.

   Para más información, consulta el Acuerdo de Servicio de Suscripción de Docker. Se recomienda leer las preguntas frecuentes.

Tip

Como administrador de TI, puedes utilizar software de gestión de dispositivos (MDM) para identificar el número de instancias de Docker Desktop y sus versiones en tu entorno. Esto puede proporcionar informes precisos sobre licencias, garantizar que tus equipos utilicen la versión más reciente de Docker Desktop y permitirte obligar a iniciar sesión.

• Intune
• Jamf
• Kandji
• Kolide
• Workspace One

Configuración avanzada del sistema y opciones de instalación

WSL: Verificación y configuración

Si has elegido utilizar WSL, primero verifica que la versión instalada cumpla con los requisitos del sistema ejecutando el siguiente comando en tu terminal:

wsl --version

Si no aparecen los detalles de la versión, es probable que estés utilizando la versión de WSL integrada en Windows (inbox). Esta versión no es compatible con las capacidades modernas y debe actualizarse.

Puedes actualizar o instalar WSL utilizando uno de los siguientes métodos:

Opción 1: Instalar o actualizar WSL a través de la terminal

1. Abre PowerShell o el Símbolo del sistema de Windows en modo administrador.
2. Ejecuta el comando de instalación o de actualización. Se te puede pedir que reinicies la máquina. Para más información, consulta Instalar WSL.

wsl --install

wsl --update

Opción 2: Instalar WSL a través del paquete MSI

Si el acceso a Microsoft Store está bloqueado debido a políticas de seguridad:

1. Ve a la página oficial de Lanzamientos de WSL en GitHub.
2. Descarga el instalador .msi de la versión estable más reciente (dentro del menú desplegable Assets).
3. Ejecuta el instalador descargado y sigue las instrucciones de configuración.

Opciones del instalador (flags)

Note

Si utilizas PowerShell, debes usar el parámetro ArgumentList antes de cualquier opción (flag). Por ejemplo:

Start-Process 'Docker Desktop Installer.exe' -Wait -ArgumentList 'install', '--accept-license'

Comportamiento de la instalación

• --user: Instala Docker Desktop en modo por usuario, en %LOCALAPPDATA%\Programs\DockerDesktop. No se requieren privilegios de administrador. Este es el modo recomendado para la mayoría de los usuarios. Consulta Modos de instalación.
• --quiet: Silencia la salida de información al ejecutar el instalador.
• --accept-license: Acepta el Acuerdo de Servicio de Suscripción de Docker ahora, en lugar de requerir su aceptación la primera vez que se ejecute la aplicación.
• --installation-dir=<path>: Cambia la ubicación de instalación predeterminada (C:\Program Files\Docker\Docker).
• --backend=<backend name>: Selecciona el backend predeterminado a utilizar en Docker Desktop: hyper-v, windows o wsl-2 (por defecto).
• --always-run-service: Una vez finalizada la instalación, inicia com.docker.service y establece el tipo de inicio del servicio en Automático. Esto evita la necesidad de privilegios de administrador, que de otro modo serian necesarios para iniciar com.docker.service. com.docker.service es requerido por los contenedores de Windows y el backend de Hyper-V.

Seguridad y control de acceso

• --allowed-org=<org name>: Requiere que el usuario inicie sesión y forme parte de la organización de Docker Hub especificada al ejecutar la aplicación.
• --admin-settings: Crea automáticamente un archivo admin-settings.json que utilizan los administradores para controlar ciertos ajustes de Docker Desktop en las máquinas de los clientes dentro de su organización. Para más información, consulta Settings Management.
  • Debe utilizarse junto con la opción --allowed-org=<org name>.
  • Por ejemplo: --allowed-org=<org name> --admin-settings="{'configurationFileVersion': 2, 'enhancedContainerIsolation': {'value': true, 'locked': false}}"
• --no-windows-containers: Deshabilita la integración de contenedores de Windows. Esto puede mejorar la seguridad. Para más información, consulta Contenedores de Windows.

Configuración de proxy

• --proxy-http-mode=<mode>: Establece el modo del proxy HTTP: system (por defecto) o manual.
• --override-proxy-http=<URL>: Establece la URL del proxy HTTP que debe utilizarse para las solicitudes HTTP salientes. Requiere que --proxy-http-mode sea manual.
• --override-proxy-https=<URL>: Establece la URL del proxy HTTP que debe utilizarse para las solicitudes HTTPS salientes. Requiere que --proxy-http-mode sea manual.
• --override-proxy-exclude=<hosts/domains>: Omite la configuración del proxy para los hosts y dominios. Utiliza una lista separada por comas.
• --proxy-enable-kerberosntlm: Habilita la autenticación de proxy Kerberos y NTLM. Si vas a habilitar esto, asegúrate de que tu servidor proxy esté configurado correctamente para la autenticación Kerberos/NTLM. Disponible con Docker Desktop 4.32 y versiones posteriores.
• --override-proxy-pac=<PAC file URL>: Establece la URL del archivo PAC. Este ajuste solo surte efecto cuando se utiliza el modo de proxy manual.
• --override-proxy-embedded-pac=<PAC script>: Especifica un script PAC (Proxy Auto-Config) integrado. Este ajuste solo surte efecto al utilizar el modo de proxy manual y tiene prioridad sobre la opción --override-proxy-pac.

Ejemplo para especificar un archivo PAC

"Docker Desktop Installer.exe" install --proxy-http-mode="manual" --override-proxy-pac="http://localhost:8080/myproxy.pac"

Ejemplo para especificar un script PAC

"Docker Desktop Installer.exe" install --proxy-http-mode="manual" --override-proxy-embedded-pac="function FindProxyForURL(url, host) { return \"DIRECT\"; }"

Ruta de datos y ubicación del disco

• --hyper-v-default-data-root=<path>: Especifica la ubicación predeterminada para el disco de la VM de Hyper-V.
• --windows-containers-default-data-root=<path>: Especifica la ubicación predeterminada para los contenedores de Windows.
• --wsl-default-data-root=<path>: Especifica la ubicación predeterminada para el disco de la distribución de WSL.

Privilegios de administrador

En el modo por usuario, Docker Desktop se puede instalar y actualizar sin privilegios de administrador. Algunas configuraciones aún requieren elevación de privilegios y están marcadas como Requires password en la interfaz de configuración. Habilitar WSL 2 por primera vez también requiere privilegios de administrador, pero esta es una operación única que se realiza por máquina.

En el modo para todos los usuarios, la instalación de Docker Desktop requiere privilegios de administrador. Sin embargo, once instalado, se puede utilizar sin acceso administrativo. Sin embargo, algunas acciones aún necesitan permisos elevados. Consulta Comprender los requisitos de permisos para Windows para más detalles.

Consulta las preguntas frecuentes sobre cómo instalar y ejecutar Docker Desktop sin necesidad de privilegios de administrador.

Si eres administrador de TI y tus usuarios no tienen derechos de administrador y planean realizar operaciones que requieren privilegios elevados, asegúrate de instalar Docker Desktop utilizando la opción del instalador --always-run-service. Esto garantiza que esas acciones se puedan seguir ejecutando sin solicitar la elevación del Control de Cuentas de Usuario (UAC). Consulta Opciones del instalador para más detalles.

Contenedores de Windows

Note

Los contenedores de Windows solo se admiten en el modo de instalación para todos los usuarios. No están disponibles cuando Docker Desktop se instala por usuario.

Desde el menú de Docker Desktop, puedes alternar con qué demonio (Linux o Windows) se comunica la CLI de Docker. Selecciona Switch to Windows containers para usar contenedores de Windows, o selecciona Switch to Linux containers para usar contenedores de Linux (el valor predeterminado).

Para obtener más información sobre los contenedores de Windows, consulta la siguiente documentación:

• Documentación de Microsoft sobre contenedores de Windows.

• Build and Run Your First Windows Server Container (Blog Post) ofrece un recorrido rápido sobre cómo crear y ejecutar contenedores Docker nativos de Windows en las versiones de evaluación de Windows 10 y Windows Server 2016.

• Getting Started with Windows Containers (Lab) te muestra cómo utilizar la aplicación MusicStore con contenedores de Windows. MusicStore es una aplicación .NET estándar y, bifurcada aquí para usar contenedores, es un buen ejemplo de una aplicación con múltiples contenedores.

• Para comprender cómo conectarse a los contenedores de Windows desde el host local, consulta Quiero conectarme a un contenedor desde Windows.

Note

Al cambiar a contenedores de Windows, Settings solo muestra aquellas pestañas que están activas y se aplican a tus contenedores de Windows.

Si configuras proxies o la configuración del demonio en el modo de contenedores de Windows, estos se aplican solo a los contenedores de Windows. Si vuelves a cambiar a contenedores de Linux, las configuraciones de proxies y del demonio regresan a lo que habías establecido para los contenedores de Linux. Los ajustes de tus contenedores de Windows se conservan y vuelven a estar disponibles cuando regresas a ese modo.

¿Qué sigue?

• Explorar las suscripciones de Docker para ver qué te puede ofrecer Docker.
• Empezar con Docker.
• Explorar Docker Desktop y todas sus características.
• Resolución de problemas describe problemas comunes, soluciones alternativas y cómo obtener soporte.
• Preguntas frecuentes proporciona respuestas a las preguntas más frecuentes.
• Notas de la versión enumera las actualizaciones de componentes, nuevas funciones y mejoras asociadas con las versiones de Docker Desktop.
• Copia de seguridad y restauración de datos proporciona instrucciones para realizar copias de seguridad y restaurar datos relacionados con Docker.