Compartir comentarios
Las respuestas se generan en base a la documentación.

Cambiar la configuración de Docker Desktop

Personaliza el comportamiento de Docker Desktop y optimiza el rendimiento y el uso de recursos con la configuración de Docker Desktop.

Para abrir Settings, realiza cualquiera de estas acciones:

  • Selecciona el menú de Docker whale menu y luego Settings
  • Selecciona el icono de Settings desde el Dashboard de Docker Desktop.

También puedes localizar el archivo settings-store.json en:

  • Mac: ~/Library/Group\ Containers/group.com.docker/settings-store.json
  • Windows: C:\Users\[USERNAME]\AppData\Roaming\Docker\settings-store.json
  • Linux: ~/.docker/desktop/settings-store.json

Para obtener información sobre cómo aplicar configuraciones a nivel de organización, consulta Settings Management.

General

Configura el comportamiento de inicio, la apariencia de la interfaz de usuario, las preferencias de la terminal y los valores predeterminados de las funciones para Docker Desktop.

ConfiguraciónDescripciónPredeterminadoPlataformaNotas
Start Docker Desktop when you sign in to your computerInicia automáticamente Docker Desktop al iniciar sesión en tu equipo.DesactivadoTodasRecomendado para usuarios frecuentes.
Open Docker Dashboard when Docker Desktop startsAbre automáticamente el dashboard al iniciar Docker Desktop.DesactivadoTodas
Choose theme for Docker DesktopAplica un tema Light o Dark a Docker Desktop.Use system settingsTodas
Configure shell completionsEdita la configuración de tu shell para habilitar el autocompletado de palabras para comandos, flags y objetos de Docker al presionar <Tab> en tu terminal. Para más información, consulta Completion.DesactivadoTodas
Choose container terminalDefine qué terminal se abre al seleccionar una terminal de contenedor. Utiliza la terminal integrada para ejecutar comandos en un contenedor en ejecución desde el Dashboard. Para más información, consulta Explore containers.DesactivadoTodas
Enable Docker terminalInteractúa con tu máquina host y ejecuta comandos directamente desde Docker Desktop.DesactivadoTodas
Enable Docker Debug by defaultUtiliza Docker Debug de forma predeterminada abriendo la terminal integrada. Para más información, consulta Explore containers.DesactivadoTodas
Include VM in Time Machine backupsRealiza una copia de seguridad de la máquina virtual de Docker Desktop.DesactivadoMac
Use containerd for pulling and storing imagesUtiliza el almacén de imágenes de containerd en lugar del almacén clásico. Para más información, consulta containerd image store.ActivadoTodas
Expose daemon on tcp://localhost:2375 without TLSPermite que los clientes antiguos se conecten al demonio de Docker. Utilízalo con precaución, ya que exponer el demonio sin TLS puede dar lugar a ataques de ejecución remota de código.DesactivadoWindows (solo backend de Hyper-V)
Use the WSL 2 based engineWSL 2 proporciona un mejor rendimiento que el backend de Hyper-V. Para más información, consulta Docker Desktop WSL 2 backend.DesactivadoWindows
Add *.docker.internal to host fileAñade entradas de DNS internas.ActivadoWindowsAyuda a resolver dominios internos de Docker
Choose Virtual Machine Manager (VMM)Elige el VMM para crear y gestionar la VM de Linux de Docker Desktop. Para más información, consulta Virtual Machine Manager.MacSelecciona Docker VMM para obtener el Hypervisor/Virtual Machine Manager más reciente y de mejor rendimiento. Esta opción solo está disponible en Macs con Apple Silicon y se encuentra en fase Beta.
Choose file sharing implementation for your containersElige si quieres compartir archivos utilizando VirtioFS, gRPC FUSE o osxfs (Legacy).VirtioFSMacUtiliza VirtioFS para un uso compartido de archivos rápido. VirtioFS ha reducido el tiempo necesario para completar operaciones del sistema de archivos en hasta un 98%. Es la única implementación de uso compartido de archivos compatible con Docker VMM.
Use Rosetta for x86_64/amd64 emulation on Apple SiliconAcelera la emulación de binarios x86/AMD64 en Apple Silicon. Esta opción solo está disponible si has seleccionado Apple Virtualization framework como Virtual Machine Manager.DesactivadoMac
Send usage statisticsEnvía diagnósticos, informes de fallos y datos de uso a Docker para mejorar y solucionar problemas de la aplicación. Docker puede pedirte más información periódicamente.ActivadoTodas
Use Enhanced Container IsolationEvita que los contenedores vulneren la VM de Linux. Para más información, consulta Enhanced Container Isolation.DesactivadoTodasDebes haber iniciado sesión y tener una suscripción de Docker Business.
Show CLI hintsMuestra sugerencias útiles de la CLI en la terminal.ActivadoTodasMejora la visibilidad de los comandos
Enable Docker Scout image analysisMuestra un botón Start analysis al inspeccionar una imagen, el cual analiza la imagen con Docker Scout.ActivadoTodas
Enable background SBOM indexingAnaliza automáticamente las imágenes que construyas o descargues.DesactivadoTodas
Automatically check configurationComprueba periódicamente tu configuración para asegurarte de que otra aplicación no haya realizado cambios inesperados. Te notifica si se encuentran cambios con la opción de restaurar la configuración directamente desde la notificación. Para más información, consulta las preguntas frecuentes.ActivadoMacDocker Desktop comprueba si tu configuración, definida durante la instalación, ha sido alterada por aplicaciones externas como Orbstack. Docker Desktop verifica los enlaces simbólicos de los binarios de Docker a /usr/local/bin y el enlace simbólico del socket de Docker predeterminado. Además, Docker Desktop se asegura de que el contexto cambie a desktop-linux al iniciar.

Resources

Controla los recursos de CPU, memoria, disco, uso compartido de archivos, proxy y red disponibles para Docker Desktop.

Advanced

ConfiguraciónDescripciónPlataformaNotas
CPU limitEspecifica la cantidad máxima de CPUs que utilizará Docker Desktop.Mac, Linux, Windows Hyper-V
Memory limitRAM asignada a la VM de DockerMac, Linux, Windows Hyper-VPor defecto es el 50% de la memoria de tu host.
SwapConfigura el tamaño del archivo de intercambio (swap) según sea necesario.Mac, Linux, Windows Hyper-V1 GB por defecto.
Disk usage limitEspecifica la cantidad máxima de espacio de disco que el motor puede utilizar.Mac, Linux, Windows Hyper-V
Disk image locationEspecifica la ubicación del volumen de Linux donde se almacenan los contenedores y las imágenes. En la pestaña Advanced, puedes limitar los recursos disponibles para la VM de Linux de Docker.Mac, Linux, Windows Hyper-VTambién puedes mover la imagen de disco a otra ubicación. Si intentas mover una imagen de disco a una ubicación que ya tiene una, se te preguntará si quieres usar la imagen existente o reemplazarla.
Resource SaverHabilita o deshabilita el modo Resource Saver, el cual reduce significativamente el uso de CPU y memoria en el host al apagar automáticamente la VM de Linux cuando Docker Desktop está inactivo.Mac, Linux, Windows Hyper-VSe reinicia automáticamente cuando se ejecutan contenedores. El reinicio puede tardar entre 3 y 10 segundos.

En el modo WSL 2, configura los límites de memoria, CPU y swap en la VM auxiliar de WSL 2.

Tip

Si notas que Docker Desktop comienza a ralentizarse o si estás ejecutando cargas de trabajo con múltiples contenedores, aumenta la asignación de memoria y el espacio de la imagen de disco.

File sharing

Utiliza File sharing para permitir que los directorios locales de tu máquina se compartan con los contenedores de Linux. Esto es especialmente útil para editar código fuente en un IDE en el host mientras ejecutas y pruebas el código en un contenedor.

ConfiguraciónDescripciónPlataformaNotas
Synchronized file sharesUso compartido de archivos de host a VM rápido y flexible, que mejora el rendimiento de los montajes de tipo bind mediante el uso de cachés de sistema de archivos sincronizadas. Para saber más, consulta Synchronized file share.Mac, Linux, Windows Hyper-VDisponible con suscripciones Pro, Team y Business.
Virtual file sharesComparte directorios locales con contenedores de Linux. Por defecto se comparten los directorios /Users, /Volumes, /private, /tmp y /var/folders. Si tu proyecto está fuera de estos directorios, debes añadirlo a la lista; de lo contrario, podrías recibir errores del tipo Mounts denied o cannot start service en tiempo de ejecución.Mac, Linux, Windows Hyper-V
  • Comparte únicamente los directorios que necesites con el contenedor. El uso compartido de archivos introduce una sobrecarga, ya que cualquier cambio en los archivos del host debe notificarse a la VM de Linux. Compartir demasiados archivos puede provocar una carga elevada de la CPU y un rendimiento lento del sistema de archivos.
  • Las carpetas compartidas están diseñadas para permitir que el código de la aplicación se edite en el host mientras se ejecuta en los contenedores. Para elementos que no sean código, como directorios de caché o bases de datos, el rendimiento será mucho mejor si se almacenan en la VM de Linux, utilizando un volumen de datos (volumen con nombre) o un contenedor de datos.
  • Si compartes todo tu directorio personal dentro de un contenedor, Mac puede pedirte que des acceso a Docker a áreas personales de tu directorio de inicio, como tus recordatorios o descargas.
  • De forma predeterminada, los sistemas de archivos de Mac no distinguen entre mayúsculas y minúsculas, mientras que Linux sí lo hace. En Linux, es posible crear dos archivos independientes: test and Test, mientras que en Mac estos nombres se referirían en realidad al mismo archivo subyacente. Esto puede provocar problemas en los que una aplicación funciona correctamente en la máquina de un desarrollador (donde se comparten los contenidos de los archivos) pero falla cuando se ejecuta en Linux en producción (donde los contenidos de los archivos son distintos). Para evitar esto, Docker Desktop insiste en que se acceda a todos los archivos compartidos respetando su mayúsculas y minúsculas originales. Por lo tanto, si se crea un archivo llamado test, se debe abrir como test. Los intentos de abrir Test fallarán con el error "No such file or directory". Del mismo modo, una vez creado un archivo llamado test, los intentos de crear un segundo archivo llamado Test fallarán.

Para más información, consulta El montaje de volúmenes requiere el uso compartido de archivos para cualquier directorio de proyecto fuera de /Users.

Proxies

Docker Desktop admite proxies HTTP/HTTPS y SOCKS5 proxies. SOCKS5 requiere una suscripción de Business.

Para evitar que los desarrolladores cambien accidentalmente la configuración del proxy, consulta Settings Management.

Proxy de Docker Desktop

Se utiliza para iniciar sesión en Docker, descargar y subir imágenes, obtener artefactos durante la compilación de imágenes y reportar diagnósticos de errores.

Modo proxyDescripción
System proxyUtiliza el proxy configurado en el host (estático o configuración automática de proxy (PAC)). Docker Desktop lo lee automáticamente.
No proxySe conecta directamente sin un proxy.
Manual configurationIntroduce manualmente una URL de Web Server (HTTP) y de Secure Web Server (HTTPS). Utiliza el formato http://proxy:port o https://proxy:port. También puedes especificar hosts y dominios que deben omitir el proxy, por ejemplo: registry-1.docker.com,*.docker.com,10.0.0.0/8.
Note

Si utilizas un archivo PAC alojado en un servidor web, añade el tipo MIME application/x-ns-proxy-autoconfig para la extensión .pac. Sin esto, es posible que el archivo PAC no se analice correctamente. Consulta Hardened Docker Desktop.

Proxy de contenedores

Se utiliza para el tráfico saliente desde los contenedores en ejecución.

Modo proxyDescripción
Same as host proxyUtiliza la misma configuración de proxy que el proxy de Docker Desktop.
System proxyUtiliza el proxy configurado en el host.
No proxySe conecta directamente sin un proxy.
Manual configurationIntroduce manualmente una URL de Web Server (HTTP) y de Secure Web Server (HTTPS). Utiliza el formato http://proxy:port o https://proxy:port. También puedes especificar hosts y dominios que deben omitir el proxy, por ejemplo: registry-1.docker.com,*.docker.com,10.0.0.0/8.
Note

El proxy HTTPS utilizado para el escaneo de imágenes se configura mediante la variable de entorno HTTPS_PROXY.

Autenticación de proxy

MétodoComportamientoNotas
BasicDocker Desktop solicita credenciales y las guarda en el almacén de credenciales del sistema operativo.Utiliza una URL de proxy https:// para proteger las contraseñas en tránsito. Admite TLS 1.3.
Kerberos / NTLMCentraliza la autenticación; no se les solicita credenciales a los desarrolladores, lo que reduce el riesgo de bloqueos de cuentas. Si el proxy devuelve múltiples esquemas en una respuesta 407, Docker Desktop usará Basic por defecto.Requiere una suscripción de Business. Para habilitar la autenticación de proxy Kerberos o NTLM, debes pasar la opción del instalador --proxy-enable-kerberosntlm durante la instalación a través de la línea de comandos y asegurarte de que tu servidor proxy esté configurado correctamente para la autenticación Kerberos o NTLM.

Network

Note

En Windows, la pestaña Network no está disponible en el modo de contenedores de Windows porque Windows gestiona las redes.

ConfiguraciónDescripciónPlataforma
Docker subnetEstablece una subred personalizada para evitar conflictos con las IPs de tu entorno. Docker Desktop utiliza una red IPv4 privada para los servicios internos, que incluye un servidor DNS y un proxy HTTP. Por defecto: 192.168.65.0/24.Todas
Use kernel networking for UDPUtiliza una ruta de red del kernel más eficiente para el tráfico UDP. Puede no ser compatible con algunos softwares VPN.Mac
Enable host networkingPermite que los contenedores iniciados con --net=host utilicen localhost para conectarse a servicios TCP y UDP en el host. También permite que el software del host use localhost para conectarse a los servicios TCP y UDP del contenedor.Mac

En Windows y Mac, también puedes configurar el modo de red predeterminado y el comportamiento de la resolución DNS. Para más información, consulta Networking.

WSL integration (solo Windows)

ConfiguraciónDescripciónNotas
Integración de distribuciones de WSLSelecciona en qué distribuciones de WSL 2 se habilita la integración de Docker con WSL.La integración está habilitada en tu distribución predeterminada de WSL de forma predeterminada. Para cambiar tu distribución predeterminada, ejecuta wsl --set-default <nombre de distribución>.

Para obtener más detalles sobre la configuración de Docker Desktop para usar WSL 2, consulta Docker Desktop WSL 2 backend.

Docker Engine

Configura el demonio de Docker utilizando un archivo de configuración JSON.

El archivo está ubicado en $HOME/.docker/daemon.json. Edítalo directamente en el Dashboard de Docker Desktop o en un editor de texto.

Para ver la lista completa de opciones de configuración posibles, consulta la referencia del comando dockerd.

Builders

Utiliza la pestaña Builders para inspeccionar y gestionar constructores (builders) en la configuración de Docker Desktop.

Inspeccionar

Para inspeccionar constructores, busca el constructor que deseas inspeccionar y selecciona el icono de expansión. Solo puedes inspeccionar constructores activos.

La inspección de un constructor activo muestra:

  • Versión de BuildKit
  • Estado
  • Tipo de controlador (driver)
  • Capacidades y plataformas soportadas
  • Uso de disco
  • Dirección del punto de conexión (endpoint)

Seleccionar un constructor diferente

La sección Selected builder muestra el constructor seleccionado. Para seleccionar un constructor diferente:

  1. Busca el constructor que deseas utilizar en Available builders
  2. Abre el menú desplegable junto al nombre del constructor.
  3. Selecciona Use para cambiar a este constructor.

Tus comandos de construcción ahora utilizarán el constructor seleccionado por defecto.

Crear un constructor

Para crear un constructor, utiliza la CLI de Docker. Consulta Crear un nuevo constructor.

Eliminar un constructor

Puedes eliminar un constructor si:

Para eliminar un constructor:

  1. Busca el constructor que deseas eliminar en Available builders
  2. Abre el menú desplegable.
  3. Selecciona Remove para eliminar este constructor.

Si el constructor utiliza el controlador docker-container o kubernetes, también se eliminará la caché de construcción junto con el constructor.

Detener e iniciar un constructor

Los constructores que utilizan el controlador docker-container ejecutan el demonio de BuildKit en un contenedor. Puedes iniciar y detener el contenedor de BuildKit utilizando el menú desplegable.

Ejecutar una compilación inicia automáticamente el contenedor si está detenido.

Solo puedes iniciar y detener constructores que utilicen el controlador docker-container.

AI

Desde la pestaña AI, puedes configurar los ajustes para:

  • Gordon, el asistente impulsado por IA que realiza acciones en tus flujos de trabajo de Docker.
  • Docker Model Runner, que facilita la gestión, ejecución y despliegue de modelos de IA utilizando Docker.

Kubernetes

Note

En Windows, la pestaña Kubernetes no está disponible en el modo de contenedores de Windows.

Habilita y configura el clúster autónomo incorporado de Kubernetes para probar despliegues de contenedores.

ConfiguraciónDescripción
Enable KubernetesInstala y ejecuta un servidor independiente de Kubernetes como contenedor de Docker para probar despliegues.
Cluster provisioning methodElige entre Kubeadm, un clúster de un solo nodo con la versión definida por Docker Desktop, o Kind, un clúster de múltiples nodos donde puedes definir la versión y el número de nodos.
Show system containers (advanced)Muestra contenedores internos al utilizar comandos de Docker.
Reset Kubernetes clusterElimina todos los stacks y recursos de Kubernetes.

Para obtener más información sobre el uso de la integración de Kubernetes con Docker Desktop, consulta Explore the Kubernetes view.

Software updates

Gestiona cómo y cuándo comprueba y descarga actualizaciones Docker Desktop.

ConfiguraciónDescripciónPredeterminado
Automatically check for updatesTe notifica sobre las actualizaciones disponibles en el menú de Docker y en el pie de página del Dashboard.Activado
Always download updatesDescarga automáticamente las nuevas versiones de Docker Desktop en segundo plano.Desactivado
Automatically update componentsActualiza los componentes de Docker Desktop (como Docker Compose, Docker Scout y la CLI de Docker) de forma independiente, sin necesidad de un reinicio completo.Activado

Extensions

Habilita las Extensiones de Docker y controla qué extensiones están disponibles para instalar y ejecutar.

ConfiguraciónDescripción
Enable Docker ExtensionsActiva o desactiva las Extensiones de Docker. Desactivado de forma predeterminada.
Allow only extensions distributed through the Docker MarketplaceRestringe las extensiones únicamente a fuentes aprobadas de Marketplace.
Show Docker Extensions system containersMuestra los contenedores utilizados por las Extensiones de Docker.

Para más información sobre las extensiones de Docker, consulta Docker Extensions.

Beta features

Las funciones Beta proporcionan acceso a funciones futuras del producto. Estas características están destinadas únicamente a pruebas y comentarios, ya que pueden cambiar entre versiones sin previo aviso o eliminarse por completo en una versión futura. Las funciones Beta no deben utilizarse en entornos de producción. Docker no ofrece soporte para las funciones Beta.

También puedes registrarte en el Developer Preview program desde la pestaña Beta features.

Para obtener una lista de las funciones experimentales actuales en la CLI de Docker, consulta Docker CLI Experimental features.

Notifications

Elige qué tipos de notificaciones de Docker Desktop deseas recibir.

Tipo de notificaciónPredeterminado
Actualizaciones de estado en tareas y procesosActivado
Recomendaciones de DockerActivado
Anuncios de DockerActivado
Encuestas de DockerActivado
Notificaciones de erroresSiempre activado (no se puede cambiar)
Nuevos lanzamientosSiempre activado (no se puede cambiar)

Las notificaciones aparecen brevemente en la parte inferior derecha del Dashboard de Docker Desktop, luego se mueven al panel de Notifications, accesible desde la parte superior derecha del Dashboard.

Advanced (solo Mac)

Reconfigura las rutas de instalación de las herramientas de CLI y los permisos privilegiados del sistema establecidos durante la instalación inicial.

ConfiguraciónDescripciónNotas
CLI tools installation — SystemInstala las herramientas de CLI de Docker en /usr/local/bin.
CLI tools installation — UserInstala las herramientas de CLI de Docker en $HOME/.docker/binAñade $HOME/.docker/bin a tu PATH agregando export PATH=$PATH:~/.docker/bin a ~/.bashrc o ~/.zshrc, y luego reinicia tu shell.
Allow the default Docker socket to be usedCrea /var/run/docker.sock, que algunos clientes de terceros pueden utilizar para comunicarse con Docker Desktop. Para más información, consulta requisitos de permisos para macOS.Requiere contraseña
Allow privileged port mappingInicia el proceso auxiliar privilegiado que vincula los puertos del 1 al 1024. Para más información, consulta requisitos de permisos para macOS.Requiere contraseña

Docker Offload

Habilita Docker Offload y configura el tiempo de espera por inactividad y el soporte de GPU para cargas de trabajo basadas en la nube.

ConfiguraciónDescripciónNotas
Enable Docker OffloadEjecuta tus contenedores en la nube.Requiere inicio de sesión y una suscripción a Offload
Idle timeoutEstablece el periodo de tiempo sin actividad antes de que Docker Offload entre en modo inactivo. Para obtener detalles sobre el tiempo de espera de inactividad, consulta Active and idle states.
Enable GPU supportPermite que tus cargas de trabajo utilicen la GPU de la nube si está disponible.