Docker Desktop no se inicia
Ver como MarkdownEl 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 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: el requisito previo de Docker Desktop
- Requisitos del sistema: plataformas y arquitecturas compatibles