Este contenido describe varios fallos de Immich superficialmente similares, pero no una solución universal. La aplicación Immich del autor original, que aparecía atenuada, se recuperó inmediatamente después de ejecutar sudo systemctl restart docker. Otro usuario probó el mismo comando y aun así no pudo iniciar Immich. Su error posterior mostró que el puerto del host 2283 ya estaba asignado, lo cual es un problema distinto de un demonio de Docker detenido.
La lección clave es esta: después de una actualización del sistema operativo, determina primero si Docker está funcionando mal, si solo un proyecto de Compose está afectado o si un contenedor obsoleto o duplicado ya ocupa el puerto que Immich necesita.
Comprueba primero el estado del servicio de Docker
La primera recomendación de 777-Spider fue comprobar si Docker se estaba ejecutando correctamente. Después, el autor original reinició Docker e informó de que todo volvió a funcionar.
Reiniciar Docker afecta a todos los contenedores del host, así que hazlo deliberadamente y espera que las demás aplicaciones se reinicien.
Reiniciar Docker no fue una solución universal para Immich
Chris informó de que el mismo reinicio de Docker ayudó a otras aplicaciones, pero no restauró Immich. Esto demuestra directamente que systemctl restart docker no debe considerarse una solución garantizada.
Uno de los errores de la fuente mostró explícitamente que el puerto 2283 ya estaba asignado
Para un caso equivalente actual, identifica qué contenedor o proceso es el propietario del puerto 2283 antes de eliminar o recrear nada. Los contenedores antiguos duplicados de Immich o un proyecto de Compose recreado parcialmente pueden dejar un puerto ocupado.
No se pudo iniciar la aplicación de Compose: un error de la pila de aplicaciones
Si Docker ejecuta Paperless u otras aplicaciones con normalidad, pero Immich falla con un error de Compose, revisa el estado y los registros de los servicios de Immich, así como su definición actual de Compose, en lugar de reinstalar todo el sistema operativo.
La reinstalación ayudó a un usuario, pero costó tiempo y volver a copiar los datos
Chris finalmente reinstaló Immich y volvió a copiar las fotos. Advirtió explícitamente sobre la necesidad de contar con copias de seguridad. Fue una decisión de último recurso de ese usuario, no una solución confirmada para todos.
Conserva AppData y la base de datos de Immich antes de reinstalar
El estado de Immich no se limita a la carpeta de fotos. Conserva la base de datos, la configuración de la aplicación y las rutas de las bibliotecas antes de eliminar contenedores o volúmenes. El ZimaOS actual mantiene los datos importantes de las aplicaciones fuera de los contenedores desechables.
Utiliza el modelo actual de datos persistentes de las aplicaciones de ZimaOS.
No consideres esto una regresión actual de Immich 1.7.1
La fuente corresponde específicamente a ZimaOS 1.5.4 y a una generación anterior de Immich. El ZimaOS actual y Immich v3 son considerablemente más recientes, así que reproduce el error exacto actual antes de aplicar una solución alternativa de 2026.
Volver a una versión anterior de Immich puede ser peligroso después de migraciones de la base de datos
Un usuario de la fuente dijo que volvió a una versión anterior de Immich. Las actualizaciones de versiones principales actuales pueden migrar el estado de la base de datos y de la aplicación, por lo que la compatibilidad con una versión anterior debe basarse en las instrucciones de la versión correspondiente de Immich, no simplemente en cambiar una etiqueta de imagen a una anterior.
Un conflicto de puertos requiere identificar el proceso que ya está escuchando
El error de la fuente indica explícitamente que Docker no pudo enlazar el puerto 2283 del host porque ya estaba asignado. Esto puede ocurrir cuando un contenedor antiguo de Immich sigue ejecutándose, cuando una segunda pila utiliza el mismo puerto o cuando otro servicio está asignado a él.
Antes de eliminar nada, identifica el contenedor o proceso actual que utiliza el puerto y decide qué pila debe ser la propietaria.
Un mosaico de aplicación atenuado puede ser un síntoma del estado de Docker, no de una pérdida de datos de Immich
Para el autor original, reiniciar Docker restauró todas las aplicaciones. Esto significa que el estado atenuado de Immich se debía al tiempo de ejecución de los contenedores, no que la base de datos de fotos o la biblioteca hubieran sido eliminadas.
Otro participante no recuperó Immich con el mismo reinicio, lo que demuestra por qué el síntoma de la interfaz, por sí solo, no basta para diagnosticar la causa raíz.
Lee el fallo de Compose antes de reinstalar
«No se pudo iniciar la aplicación de Compose» es un error genérico. La información útil está en el mensaje subyacente del servicio o contenedor: conflicto de puertos, volumen ausente, fallo de salud de la base de datos, problema al descargar la imagen, YAML no válido o problema de permisos.
Conserva los registros del fallo antes de recrear la pila; una reinstalación puede borrar las pruebas.
El Immich v3 actual hace que volver a una versión anterior sin comprobar sea más peligroso
Desde entonces, Immich ha experimentado cambios importantes de esquema y despliegue. Puede que una base de datos moderna de v3 no pueda ejecutarse de forma segura con una imagen anterior arbitraria, aunque un usuario de 2026 haya vuelto en alguna ocasión a una versión v1.x.
Sigue las instrucciones actuales de Immich para migraciones y versiones anteriores, y conserva copias de seguridad verificadas de la base de datos y de la biblioteca antes de realizar cambios de versión importantes.
Si es necesario reinstalar, conserva primero las rutas persistentes
Registra la biblioteca de fotos, los datos de PostgreSQL, la configuración, las rutas de aprendizaje automático y caché, y las asignaciones de volúmenes actuales. Eliminar contenedores desechables es muy distinto de borrar esas carpetas persistentes del host.
Una reinstalación limpia correcta debería volver a conectar los datos persistentes previstos o restaurarlos mediante una copia de seguridad compatible, no obligarte a volver a copiar desde cero la única biblioteca de fotos.
Preguntas frecuentes sobre el fallo de Immich 1.5.4
¿Reiniciar Docker solucionó el problema de Immich del autor original?
Sí.
¿Lo solucionó para todos los usuarios del hilo?
No. Immich siguió fallando para otro usuario y posteriormente mostró un conflicto con el puerto 2283.
¿Los usuarios actuales deberían reinstalar Immich inmediatamente?
No. Primero identifica el estado del servicio de Docker, el estado de Compose, el propietario del puerto y los datos persistentes.
