¿Qué límite de memoria deberías establecer para Immich?

Eva Wong es la redactora técnica y manitas residente en ZimaSpace. Es una geek de toda la vida apasionada por los laboratorios domésticos y el software de código abierto, y se especializa en traducir conceptos técnicos complejos en guías prácticas y fáciles de seguir. Eva cree que alojar servicios propios debería ser divertido, no intimidante. A través de sus tutoriales, ayuda a la comunidad a desmitificar la configuración del hardware, desde montar su primer NAS hasta dominar los contenedores Docker.

No establezcas un único límite de memoria para Immich basándote en una cifra universal de GB. Un objetivo de RAM para el host y un límite por contenedor resuelven problemas distintos: el host debe poder ejecutar toda la pila, mientras que el límite del contenedor debe protegerlo sin terminar una carga de trabajo legítima de Immich.

Navegar por una biblioteca procesada puede parecer poco exigente, mientras que un inicio en frío del aprendizaje automático, una importación grande, la generación de miniaturas, el análisis facial o el procesamiento de vídeo pueden consumir mucha más memoria. Mide la carga de trabajo más intensa que realmente necesitas, deja margen para PostgreSQL y el sistema operativo, y considera que las terminaciones repetidas por OOM indican que el límite es insuficiente, no una limitación normal.

Mide la presión de memoria antes de elegir el límite

Registra el uso de memoria en tres situaciones: navegación sin actividad, una carga diaria representativa y la carga en segundo plano más intensa prevista. Captura el uso del contenedor, la memoria disponible en el host, la actividad de la memoria de intercambio, los eventos OOM y si los trabajos siguen avanzando. Un único pico de docker stats no basta, porque la contabilidad de memoria de Linux incluye varios tipos de memoria con distintos comportamientos de recuperación.

Un desglose de la memoria de Docker cgroup útil distingue entre memoria anónima, caché respaldada por archivos y slab, en lugar de tratar el total bruto como si todo fuera igual de peligroso. Una caché de archivos estable con suficiente memoria disponible en el host no es lo mismo que un aumento constante de la memoria anónima, presión sobre la memoria de intercambio o un contador OOM de cgroup que aumenta durante el mismo trabajo de Immich.

Supera esta etapa cuando puedas identificar un máximo de uso repetible y explicar si se debe principalmente a caché recuperable o a memoria de trabajo activa. Si el uso sigue aumentando con una carga de trabajo sin cambios, un contenedor sufre repetidamente terminaciones por OOM o el host empieza a usar mucho la memoria de intercambio, deja de dimensionar a partir de esa ejecución y diagnostica primero el crecimiento anómalo.

Ajusta el límite a la carga de trabajo válida más exigente de Immich

Elige la carga de trabajo que debe seguir funcionando después de aplicar el límite. En un hogar, podría consistir en cuatro teléfonos subiendo archivos mientras Smart Search y las tareas de reconocimiento facial se ponen al día; en otro, en una importación inicial grande seguida de la navegación habitual. Mantén fijos el conjunto de datos, el modelo, los ajustes de concurrencia y los demás contenedores durante las mediciones, para que el límite refleje una garantía de servicio definida.

Fija el límite estricto por encima del pico observado de memoria no recuperable, con un margen medible suficiente para ráfagas breves y preservando memoria del host para PostgreSQL, la caché del sistema de archivos, el entorno de ejecución de contenedores y otros servicios. La lista de verificación relacionada de ZimaSpace sobre señales de advertencia de recursos para la IA local resulta útil porque el calor, el uso de memoria de intercambio y los reinicios repentinos revelan una presión en el host que puede pasar inadvertida en un gráfico que solo muestra Immich. No interpretes «el contenedor alcanzó el límite una vez» como prueba de que se necesita más RAM. Lo importante es determinar si la misma carga de trabajo válida se ralentiza mucho, pierde tareas, usa memoria de intercambio continuamente o termina por falta de memoria (OOM). Por el contrario, el límite es demasiado holgado si Immich puede privar de recursos a la base de datos o al host antes de que su propio grupo de control (cgroup) alcance el límite.

Reduce la carga de trabajo antes de elevar un límite para un crecimiento anómalo

Si el límite propuesto falla únicamente durante una clase de tareas en segundo plano, reduce la concurrencia de esa tarea o aísla la etapa antes de elevar el límite máximo. El aprendizaje automático, la generación de miniaturas, el procesamiento de video y las tareas de bases de datos pueden tener distintos perfiles de memoria. Un lote activo más pequeño puede tardar más en completarse, pero mantiene ágil la interfaz del hogar y permite recuperar el host.

También importan los fallos específicos de una versión. Un informe sobre la memoria de Immich v3.0.3 describió un proceso de aprendizaje automático que consumía cada vez más memoria hasta que se alcanzó el límite del cgroup y se produjo un cierre por falta de memoria (OOM), tras una condición anómala relacionada con la configuración regional. Ese caso no define el uso normal de RAM de Immich; demuestra por qué un aumento inexplicable del consumo debería tratarse como un problema de software o de configuración antes de aumentar de forma permanente el presupuesto de memoria del host.

Tras cambiar una variable de concurrencia, modelo o versión, vuelve a ejecutar la misma carga de trabajo. Conserva el cambio solo si tanto el perfil de memoria como el trabajo original mejoran en la dirección prevista. Si el uso de memoria sigue aumentando sin acercarse a una meseta estable, conserva los registros y los detalles de la versión y eleva el problema, en lugar de convertir el límite estricto en una cifra cada vez mayor.

Valida el límite tras un reinicio en frío y un ciclo de mucha actividad

Reinicia el host para que las cachés y la residencia del modelo partan de un estado en frío conocido. Realiza las comprobaciones habituales de inicio de sesión y navegación, y luego la carga representativa y la carga de trabajo en segundo plano. Registra el pico de memoria anónima, la caché, el intercambio, los contadores OOM, la respuesta de la base de datos, el tiempo de vaciado de la cola y si otro contenedor importante sigue respondiendo.

Un límite que se supera con éxito resiste tanto un arranque en frío como el ciclo normal de mayor actividad sin provocar cierres por falta de memoria (OOM), actividad de intercambio sostenida e intensa, reinicios repetidos de contenedores ni una cola que deje de vaciarse. También debería dejar suficiente margen en el host para tareas de recuperación, como un volcado de la base de datos o un inicio de sesión administrativo, cuando Immich está ocupado.

Si solo falla una prueba de estrés artificial, mientras que todas las cargas de trabajo domésticas definidas se completan, documenta el límite aceptado en lugar de comprar RAM para un escenario que no necesitas.

Si una carga de trabajo real no puede completarse sin agotar el host, reduce la concurrencia, aísla el aprendizaje automático, añade memoria o traslada los servicios que compiten por los recursos; luego repite la misma validación antes de declarar seguro el nuevo límite.

Soporte y consejos

Más para leer

Get More Builds Like This

Stay in the Loop

Get updates from Zima - new products, exclusive deals, and real builds from the community.

Stay in the Loop preferences

We respect your inbox. Unsubscribe anytime.