Системная целостность

Проверки папок

информация

Папки, используемые для этих проверок, включают: upload/, library/, thumbs/, encoded-video/, profile/, backups/

При запуске Immich выполняет серию проверок, чтобы убедиться, что он может читать и записывать файлы в тома, которые используются хранилищем. Если он не может выполнить все необходимые операции, запуск завершится неудачно. Проверки включают:

• Создание скрытого файла (.immich) в каждой папке
• Чтение скрытого файла (.immich) в каждой папке
• Перезапись скрытого файла (.immich) в каждой папке

Проверки направлены на выявление следующих ситуаций:

• Неправильные разрешения (нельзя читать/записывать файлы)
• Отсутствие монтирования тома (файлы .immich должны существовать, но отсутствуют)

Частые проблемы

заметка

Файлы .immich служат маркерами и помогают отслеживать монтируемые тома, используемые Immich. За исключением указанных ниже ситуаций, их нельзя создавать или удалять вручную.

Отсутствующие файлы .immich

Проверка монтирования системных папок (enabled=true)
...
ENOENT: такой файл или каталог отсутствует, открытие файла 'upload/encoded-video/.immich'

Сообщения об ошибках выше показывают, что сервер ранее (успешно) записал файлы .immich в каждую папку, но теперь их не обнаруживает. Это может быть связано с одним из следующих причин:

• Ошибка разрешений - невозможно прочитать файл, хотя он существует
• Файл не существует - монтирование тома изменилось и должно быть исправлено
• Файл не существует - пользователь удалил его вручную и должен создать файл заново (touch .immich)
• Файл не существует - пользователь восстановил из резервной копии, но не восстановил каждую папку (пользователь должен восстановить все папки или вручную создать .immich в недостающих папках)

Игнорирование проверок

предупреждение

Проверки предназначены для выявления распространенных проблем, с которыми сталкивались пользователи в прошлом, и часто указывают на наличие проблемы, которую следует решить. Если вы знаете, что делаете, и хотите отключить их, вы можете установить следующую переменную окружения:

IMMICH_IGNORE_MOUNT_CHECK_ERRORS=true