---
title: Docker Desktop no se inicia
summary: El fallo más común en la primera ejecución: HeartBeatAgents requiere que Docker Desktop esté en marcha antes de poder iniciar cualquier agente.
date: 2026-09-03
---

# Docker Desktop no se inicia

El fallo más común en la primera ejecución: HeartBeatAgents requiere que Docker Desktop esté en marcha antes de poder iniciar cualquier agente.

HeartBeatAgents usa Docker para aislar el entorno de ejecución de cada agente (ver [Seguridad](/es/docs/guides/security)): es un requisito obligatorio en todas las plataformas, no opcional. Si la aplicación se queda colgada al iniciarse o los agentes no arrancan, que Docker no esté en marcha es la causa más probable.

## Comprueba que Docker Desktop está realmente en marcha

Busca el icono de la ballena de Docker en la bandeja del sistema (Windows) o en la barra de menús (macOS). Si falta, inicia Docker Desktop manualmente y espera a que indique "Docker Desktop is running" antes de volver a abrir HeartBeatAgents.

## Causas comunes

- **Virtualización no habilitada**: en Windows, Docker Desktop requiere WSL 2 o Hyper-V. Comprueba en las características de Windows "Plataforma de máquina virtual" y "Subsistema de Windows para Linux".
- **Recursos insuficientes**: los propios ajustes de Docker Desktop (Preferencias → Recursos) limitan cuánta CPU/RAM puede usar. Si están demasiado bajos, los contenedores pueden fallar al iniciarse bajo carga.
- **Un proceso Docker anterior no se cerró correctamente**: reinicia Docker Desktop por completo (ciérralo desde el icono de la bandeja/barra de menús, no solo cerrando la ventana) en lugar de relanzarlo sobre una instancia bloqueada.

## ¿Sigues atascado?

Revisa los propios registros de diagnóstico de Docker Desktop (Docker Desktop → Troubleshoot → Get support). La mayoría de los fallos de inicio ocurren a nivel de Docker, no de HeartBeatAgents, y los diagnósticos de Docker suelen indicar la causa exacta.

## Relacionado

- [Instalación](/es/docs/getting-started/installation): el requisito previo de Docker Desktop
- [Requisitos del sistema](/es/docs/getting-started/system-requirements): plataformas y arquitecturas compatibles
