Para reiniciar contenedores Docker con seguridad, ejecuta docker restart sobre el nombre o ID del objeto. Docker detiene el proceso con la señal configurada, espera a que cierre y vuelve a iniciar el mismo contenedor. Aquí verás cómo comprobar el resultado y cuándo investigar el fallo en lugar de repetir el reinicio.
Un reinicio manual sirve para recuperar temporalmente un proceso o aplicar un apagado y arranque controlados. No repara la causa de un fallo recurrente ni actualiza la imagen o la configuración del contenedor.
👉 Y recuerda, si quieres aprender más de Linux, visita el curso de Linux gratis.
🐳 Si quieres aprender más de Docker, visita el curso de Docker gratis.
Reiniciar contenedores Docker: qué hace docker restart
Al reiniciar contenedores Docker con docker restart, el motor detiene y vuelve a iniciar el mismo objeto con su configuración actual. Durante la parada envía la señal configurada; si el proceso no termina dentro del tiempo de espera, Docker lo fuerza y lo arranca de nuevo. La capa escribible y los montajes siguen asociados porque el contenedor no se elimina.
docker run -d --name restart-demo nginx:alpine
docker restart restart-demo
docker logs --tail 20 restart-demo
docker inspect restart-demo --format '{{.State.Status}} {{.RestartCount}}'
docker rm -f restart-demoQué comprobar al reiniciar contenedores Docker
El comando devuelve el nombre del contenedor si la operación se completa, pero eso no demuestra que la aplicación esté sana. Comprueba que el estado sea running, revisa las últimas líneas del registro y, si la imagen define un HEALTHCHECK, observa también su estado de salud. Un proceso puede seguir activo aunque el servicio que ofrece no responda.
En el ejemplo, docker logs muestra la salida reciente del proceso y docker inspect permite consultar el estado y el número de reinicios registrados. Si los registros muestran el mismo error tras cada arranque, deja de reiniciar en bucle y diagnostica la configuración, las dependencias o los recursos.
Reiniciar contenedores Docker manualmente o con una política automática
docker restart es una acción manual puntual: detiene y vuelve a iniciar un contenedor que eliges. Una política de reinicio como unless-stopped o on-failure define cuándo el daemon debe intentar iniciarlo automáticamente después de una salida. La política no corrige fallos de la aplicación; si el proceso falla repetidamente, busca la causa en los logs y en la configuración.
| Situación | Qué hacer | Por qué |
|---|---|---|
| Fallo puntual | Reiniciar y comprobar estado, salud y logs. | Ver si el servicio se recupera y si el problema vuelve. |
| Fallos repetidos | Revisar logs, configuración y recursos antes de otro reinicio. | La política automática puede repetir el fallo indefinidamente. |
| Cambios en la imagen o configuración | Recrear el contenedor con los parámetros nuevos. | Restart reutiliza el objeto y no aplica esos cambios. |
| Servicio en producción | Planificar la operación y revisar el impacto. | Las conexiones activas pueden interrumpirse. |
Controlar la señal y el tiempo de espera
El reinicio usa por defecto la señal de parada definida en la imagen, o SIGTERM si no hay otra señal configurada. Docker espera un tiempo antes de forzar la parada con SIGKILL; puedes ajustar el comportamiento cuando la aplicación necesita más o menos tiempo para cerrar.
- Usa –timeout para definir los segundos de espera en esta operación.
- Usa –signal solo cuando conozcas la señal que la aplicación necesita recibir.
- En Linux, el valor predeterminado general es 10 segundos; el contenedor puede tener otro tiempo configurado.
- Si el proceso no termina al vencer el plazo, Docker lo fuerza con SIGKILL y lo arranca de nuevo.
Errores comunes
- Reiniciar varias veces sin consultar los logs; el ciclo puede ocultar un fallo que se repite.
- Esperar que restart aplique cambios de imagen, puertos, montajes o variables: para cambiar la configuración hay que recrear el contenedor.
- Confundir el comando manual con una política automática de reinicio.
- Reiniciar en producción sin comprobar el impacto sobre conexiones y usuarios activos.
- Tomar el estado running como prueba de que la aplicación funciona; revisa también su respuesta o HEALTHCHECK.
Lecciones relacionadas del curso
- Ciclo de vida de un contenedor Docker: entiende estados y transiciones.
- Contenedores en segundo plano: aprende a ejecutarlos en segundo plano.
- Cómo ver logs de un contenedor Docker: diagnostica salida del proceso.
- Cómo inspeccionar un contenedor Docker: consulta configuración y estado.
Documentación oficial y recursos
- Referencia oficial de docker restart
- Políticas automáticas de reinicio
- docker container CLI reference
Usa el reinicio como una operación de recuperación controlada, no como sustituto del diagnóstico. Si el problema vuelve después de cada arranque, conserva los logs y revisa la causa antes de repetir la acción.

