Integridad del sistema

Verificaciones de carpetas

información

Las carpetas consideradas para estas verificaciones incluyen: upload/, library/, thumbs/, encoded-video/, profile/, backups/

Cuando Immich inicia, realiza una serie de verificaciones para validar que puede leer y escribir archivos en los montajes de volumen utilizados por el sistema de almacenamiento. Si no puede realizar todas las operaciones requeridas, no podrá iniciarse. Las verificaciones incluyen:

• Crear un archivo oculto inicial (.immich) en cada carpeta
• Leer un archivo oculto (.immich) en cada carpeta
• Sobrescribir un archivo oculto (.immich) en cada carpeta

Las verificaciones están diseñadas para detectar las siguientes situaciones:

• Permisos incorrectos (no puede leer/escribir archivos)
• Montaje de volumen faltante (los archivos .immich deberían existir, pero faltan)

Problemas comunes

nota

Los archivos .immich sirven como marcadores y ayudan a realizar un seguimiento de los montajes de volumen utilizados por Immich. Excepto por las situaciones enumeradas a continuación, nunca deberían ser creados o eliminados manualmente.

Archivos .immich faltantes

Verificando las carpetas de montaje del sistema (enabled=true)
...
ENOENT: no existe tal archivo o directorio, open 'upload/encoded-video/.immich'

Los mensajes de error anteriores muestran que el servidor ha escrito previamente (con éxito) archivos .immich en cada carpeta, pero ahora no los detecta. Esto podría deberse a cualquiera de las siguientes razones:

• Error de permisos: no se puede leer el archivo, pero existe
• El archivo no existe: el montaje de volumen ha cambiado y debería corregirse
• El archivo no existe: el usuario lo eliminó manualmente y debería recrearse manualmente (touch .immich)
• El archivo no existe: el usuario restauró desde una copia de seguridad, pero no restauró cada carpeta (el usuario debería restaurar todas las carpetas o crear manualmente .immich en cualquier carpeta faltante)

Ignorar las verificaciones

advertencia

Las verificaciones están diseñadas para detectar problemas comunes que hemos visto que los usuarios han tenido en el pasado, y a menudo indican que hay algo mal que debes resolver. Si sabes lo que estás haciendo y deseas deshabilitarlas, puedes establecer la siguiente variable de entorno:

IMMICH_IGNORE_MOUNT_CHECK_ERRORS=true