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
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ón | Descripción | Predeterminado | Plataforma | Notas |
|---|---|---|---|---|
| Start Docker Desktop when you sign in to your computer | Inicia automáticamente Docker Desktop al iniciar sesión en tu equipo. | Desactivado | Todas | Recomendado para usuarios frecuentes. |
| Open Docker Dashboard when Docker Desktop starts | Abre automáticamente el dashboard al iniciar Docker Desktop. | Desactivado | Todas | |
| Choose theme for Docker Desktop | Aplica un tema Light o Dark a Docker Desktop. | Use system settings | Todas | |
| Configure shell completions | Edita 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. | Desactivado | Todas | |
| Choose container terminal | Define 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. | Desactivado | Todas | |
| Enable Docker terminal | Interactúa con tu máquina host y ejecuta comandos directamente desde Docker Desktop. | Desactivado | Todas | |
| Enable Docker Debug by default | Utiliza Docker Debug de forma predeterminada abriendo la terminal integrada. Para más información, consulta Explore containers. | Desactivado | Todas | |
| Include VM in Time Machine backups | Realiza una copia de seguridad de la máquina virtual de Docker Desktop. | Desactivado | Mac | |
| Use containerd for pulling and storing images | Utiliza el almacén de imágenes de containerd en lugar del almacén clásico. Para más información, consulta containerd image store. | Activado | Todas | |
| Expose daemon on tcp://localhost:2375 without TLS | Permite 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. | Desactivado | Windows (solo backend de Hyper-V) | |
| Use the WSL 2 based engine | WSL 2 proporciona un mejor rendimiento que el backend de Hyper-V. Para más información, consulta Docker Desktop WSL 2 backend. | Desactivado | Windows | |
| Add *.docker.internal to host file | Añade entradas de DNS internas. | Activado | Windows | Ayuda 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. | Mac | Selecciona 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 containers | Elige si quieres compartir archivos utilizando VirtioFS, gRPC FUSE o osxfs (Legacy). | VirtioFS | Mac | Utiliza 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 Silicon | Acelera 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. | Desactivado | Mac | |
| Send usage statistics | Enví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. | Activado | Todas | |
| Use Enhanced Container Isolation | Evita que los contenedores vulneren la VM de Linux. Para más información, consulta Enhanced Container Isolation. | Desactivado | Todas | Debes haber iniciado sesión y tener una suscripción de Docker Business. |
| Show CLI hints | Muestra sugerencias útiles de la CLI en la terminal. | Activado | Todas | Mejora la visibilidad de los comandos |
| Enable Docker Scout image analysis | Muestra un botón Start analysis al inspeccionar una imagen, el cual analiza la imagen con Docker Scout. | Activado | Todas | |
| Enable background SBOM indexing | Analiza automáticamente las imágenes que construyas o descargues. | Desactivado | Todas | |
| Automatically check configuration | Comprueba 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. | Activado | Mac | Docker 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ón | Descripción | Plataforma | Notas |
|---|---|---|---|
| CPU limit | Especifica la cantidad máxima de CPUs que utilizará Docker Desktop. | Mac, Linux, Windows Hyper-V | |
| Memory limit | RAM asignada a la VM de Docker | Mac, Linux, Windows Hyper-V | Por defecto es el 50% de la memoria de tu host. |
| Swap | Configura el tamaño del archivo de intercambio (swap) según sea necesario. | Mac, Linux, Windows Hyper-V | 1 GB por defecto. |
| Disk usage limit | Especifica la cantidad máxima de espacio de disco que el motor puede utilizar. | Mac, Linux, Windows Hyper-V | |
| Disk image location | Especifica 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-V | Tambié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 Saver | Habilita 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-V | Se 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.
TipSi 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ón | Descripción | Plataforma | Notas |
|---|---|---|---|
| Synchronized file shares | Uso 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-V | Disponible con suscripciones Pro, Team y Business. |
| Virtual file shares | Comparte 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:
testandTest, 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 llamadotest, se debe abrir comotest. Los intentos de abrirTestfallarán con el error "No such file or directory". Del mismo modo, una vez creado un archivo llamadotest, los intentos de crear un segundo archivo llamadoTestfallará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 proxy | Descripción |
|---|---|
| System proxy | Utiliza el proxy configurado en el host (estático o configuración automática de proxy (PAC)). Docker Desktop lo lee automáticamente. |
| No proxy | Se conecta directamente sin un proxy. |
| Manual configuration | Introduce 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. |
NoteSi utilizas un archivo PAC alojado en un servidor web, añade el tipo MIME
application/x-ns-proxy-autoconfigpara 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 proxy | Descripción |
|---|---|
| Same as host proxy | Utiliza la misma configuración de proxy que el proxy de Docker Desktop. |
| System proxy | Utiliza el proxy configurado en el host. |
| No proxy | Se conecta directamente sin un proxy. |
| Manual configuration | Introduce 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. |
NoteEl proxy HTTPS utilizado para el escaneo de imágenes se configura mediante la variable de entorno
HTTPS_PROXY.
Autenticación de proxy
| Método | Comportamiento | Notas |
|---|---|---|
| Basic | Docker 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 / NTLM | Centraliza 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
NoteEn Windows, la pestaña Network no está disponible en el modo de contenedores de Windows porque Windows gestiona las redes.
| Configuración | Descripción | Plataforma |
|---|---|---|
| Docker subnet | Establece 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 UDP | Utiliza 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 networking | Permite 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ón | Descripción | Notas |
|---|---|---|
| Integración de distribuciones de WSL | Selecciona 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:
- Busca el constructor que deseas utilizar en Available builders
- Abre el menú desplegable junto al nombre del constructor.
- 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:
El constructor no es tu constructor seleccionado.
El constructor no está asociado a un contexto de Docker.
Para eliminar constructores asociados con un contexto de Docker, elimina el contexto utilizando el comando
docker context rm.
Para eliminar un constructor:
- Busca el constructor que deseas eliminar en Available builders
- Abre el menú desplegable.
- 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
NoteEn 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ón | Descripción |
|---|---|
| Enable Kubernetes | Instala y ejecuta un servidor independiente de Kubernetes como contenedor de Docker para probar despliegues. |
| Cluster provisioning method | Elige 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 cluster | Elimina 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ón | Descripción | Predeterminado |
|---|---|---|
| Automatically check for updates | Te notifica sobre las actualizaciones disponibles en el menú de Docker y en el pie de página del Dashboard. | Activado |
| Always download updates | Descarga automáticamente las nuevas versiones de Docker Desktop en segundo plano. | Desactivado |
| Automatically update components | Actualiza 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ón | Descripción |
|---|---|
| Enable Docker Extensions | Activa o desactiva las Extensiones de Docker. Desactivado de forma predeterminada. |
| Allow only extensions distributed through the Docker Marketplace | Restringe las extensiones únicamente a fuentes aprobadas de Marketplace. |
| Show Docker Extensions system containers | Muestra 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ón | Predeterminado |
|---|---|
| Actualizaciones de estado en tareas y procesos | Activado |
| Recomendaciones de Docker | Activado |
| Anuncios de Docker | Activado |
| Encuestas de Docker | Activado |
| Notificaciones de errores | Siempre activado (no se puede cambiar) |
| Nuevos lanzamientos | Siempre 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ón | Descripción | Notas |
|---|---|---|
| CLI tools installation — System | Instala las herramientas de CLI de Docker en /usr/local/bin. | |
| CLI tools installation — User | Instala las herramientas de CLI de Docker en $HOME/.docker/bin | Añ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 used | Crea /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 mapping | Inicia 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ón | Descripción | Notas |
|---|---|---|
| Enable Docker Offload | Ejecuta tus contenedores en la nube. | Requiere inicio de sesión y una suscripción a Offload |
| Idle timeout | Establece 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 support | Permite que tus cargas de trabajo utilicen la GPU de la nube si está disponible. |