Intégrité du système

Vérifications des dossiers

info

Les dossiers considérés pour ces vérifications incluent : upload/, library/, thumbs/, encoded-video/, profile/, backups/

Lors du démarrage d'Immich, une série de vérifications est effectuée afin de s'assurer qu'il peut lire et écrire des fichiers dans les volumes utilisés par le système de stockage. Si toutes les opérations requises ne peuvent pas être réalisées, le démarrage échouera. Les vérifications incluent :

• Création d'un fichier caché initial (.immich) dans chaque dossier
• Lecture d'un fichier caché (.immich) dans chaque dossier
• Réécriture d'un fichier caché (.immich) dans chaque dossier

Les vérifications sont conçues pour détecter les situations suivantes :

• Permissions incorrectes (impossibilité de lire/écrire les fichiers)
• Volume de montage manquant (les fichiers .immich devraient exister mais sont absents)

Problèmes courants

note

Les fichiers .immich servent de marqueurs et aident à suivre les volumes de montage utilisés par Immich. À l'exception des situations listées ci-dessous, ils ne doivent jamais être créés ou supprimés manuellement.

Fichiers .immich manquants

Vérification des dossiers de montage système (activée=true)
...
ENOENT : aucun fichier ou répertoire de ce type, open 'upload/encoded-video/.immich'

Les messages d'erreur ci-dessus indiquent que le serveur a précédemment (avec succès) écrit des fichiers .immich dans chaque dossier, mais qu'il ne les détecte plus désormais. Cela peut être causé par l'un des éléments suivants :

• Erreur de permission - Impossible de lire le fichier, bien qu'il existe
• Le fichier n'existe pas - Le volume de montage a changé et doit être corrigé
• Le fichier n'existe pas - Un utilisateur l'a supprimé manuellement et il doit être recréé manuellement (touch .immich)
• Le fichier n'existe pas - Un utilisateur a restauré à partir d'une sauvegarde, mais n'a pas restauré chaque dossier (l'utilisateur doit restaurer tous les dossiers ou créer manuellement le fichier .immich dans chaque dossier manquant)

Ignorer les vérifications

avertissement

Les vérifications sont conçues pour détecter les problèmes courants que les utilisateurs ont rencontrés par le passé, et indiquent souvent qu'il y a un problème que vous devriez résoudre. Si vous savez ce que vous faites et souhaitez les désactiver, vous pouvez définir la variable d'environnement suivante :

IMMICH_IGNORE_MOUNT_CHECK_ERRORS=true