Comment configurer le cache et le stockage temporaire d’Immich

Eva Wong est la rédactrice technique et bricoleuse résidente chez ZimaSpace. Geek depuis toujours, passionnée par les laboratoires informatiques personnels et les logiciels open source, elle se spécialise dans la vulgarisation de concepts techniques complexes au moyen de guides pratiques et concrets. Eva pense que l’hébergement personnel doit être amusant, et non intimidant. À travers ses tutoriels, elle aide la communauté à démystifier les configurations matérielles, de la construction de leur premier NAS à la maîtrise des conteneurs Docker.

Configurez le cache et le stockage temporaire d’Immich en séparant d’abord l’état durable de la bibliothèque, les fichiers dérivés générés, le cache réutilisable des modèles et les données temporaires réellement jetables du conteneur.

Les miniatures et les vidéos encodées peuvent ressembler à du cache parce qu’Immich peut les régénérer, mais ce sont des ressources de travail persistantes qui peuvent devenir volumineuses et coûteuses à reconstruire. Les téléchargements de modèles suivent un autre cycle de vie, tandis que les journaux et les données temporaires de la couche inscriptible ne devraient pas occuper silencieusement le disque de démarrage. Attribuez un stockage à chaque rôle, puis testez le comportement lors du nettoyage et du redémarrage.

Classez chaque rôle de stockage avant de le déplacer

Dressez un inventaire comprenant au moins quatre catégories : les originaux et l’état applicatif requis ; les miniatures et les aperçus générés ; les vidéos encodées générées ; et les données des modèles, les journaux ou les données d’exécution temporaires. Pour chaque catégorie, indiquez le chemin actuel, la taille, le taux de croissance, la politique de sauvegarde, le coût de reconstruction et le service qui y écrit.

Le témoignage d’un utilisateur sur la croissance des miniatures et des vidéos générées montre pourquoi il faut mesurer séparément les miniatures et les vidéos encodées. Les ratios individuels ne sont pas universels, car la quantité générée varie selon les types de médias et les paramètres de traitement.

Ne qualifiez pas un répertoire de « cache » simplement parce que sa suppression libère de l’espace. Si sa perte entraîne plusieurs jours de régénération, perturbe la lecture en cours ou supprime un état que votre plan de récupération prévoit de conserver, attribuez-lui explicitement un rôle persistant, même si l’application peut techniquement le recréer.

Placez les données générées à forte fréquence de modification sur un support adapté en latence et en endurance

Les miniatures et les aperçus facilitent la navigation interactive et impliquent souvent de nombreuses petites lectures, tandis que les vidéos encodées peuvent nécessiter une capacité séquentielle bien plus importante. Un SSD rapide peut accélérer les opérations qui sollicitent beaucoup les fichiers dérivés, mais seulement si le déplacement de ces données supprime le délai mesuré, au lieu de créer un autre petit volume qui se remplit à l’improviste.

L’explication de ZimaSpace sur la croissance de l’espace occupé par les miniatures met en évidence une leçon de stockage transposable : l’espace actif d’une application peut se remplir même lorsque les originaux sont stockés ailleurs. Les chemins propres à Immich diffèrent, mais il faut toujours surveiller le rôle effectivement accessible en écriture.

Si les médias volumineux restent sur un disque dur ou un NAS tandis que les fichiers dérivés sont déplacés sur un SSD, surveillez les seuils d’espace libre sur les deux supports et vérifiez tous les points de montage après un redémarrage. Un espace rapide dédié aux fichiers dérivés n’est utile que s’il est assez grand pour accompagner la croissance normale et que sa défaillance ne peut pas être confondue avec la perte des originaux faisant autorité.

Faites persister le cache des modèles de façon délibérée, mais considérez-le comme reconstructible

Les modèles de machine learning sont téléchargés ou préparés pour être utilisés de manière répétée lors de l’inférence et peuvent occuper un espace de stockage important. La persistance du cache des modèles évite les téléchargements et les tâches de démarrage inutiles, surtout lorsque la connexion est lente, mais il ne faut pas le confondre avec la base de données ou les originaux de la famille dans la hiérarchie de récupération.

Une discussion communautaire sur l’architecture de stockage d’Immich illustre pourquoi les opérateurs séparent les données assimilables à un cache rapide du stockage des photos en grande quantité. N’utilisez ces configurations qu’à titre d’exemple ; vérifiez les chemins et les montages actuels dans votre propre définition Compose avant de déplacer quoi que ce soit.

Si le cache de modèles est perdu, la solution de récupération acceptable consiste généralement à le recréer ou à le télécharger à nouveau, à condition que le service puisse accéder à la source nécessaire et dispose de suffisamment d’espace disque. Documentez ce comportement afin qu’un outil de sauvegarde ne consacre pas par inadvertance une capacité hors site limitée à la protection d’un volumineux cache régénérable.

Limiter les couches inscriptibles, les journaux et l’espace temporaire

Les couches inscriptibles des conteneurs ne doivent pas devenir un emplacement non documenté pour les dérivés persistants, les transcodages temporaires ou les journaux volumineux. Examinez l’utilisation du disque par Docker et les montages des conteneurs afin que chaque chemin volumineux en croissance soit soit conservé de façon délibérée, soit destiné à être supprimé. Une hausse inexpliquée de l’utilisation de la couche inscriptible est le symptôme d’un problème de configuration, pas une cible de nettoyage par défaut.

Le processus Docker HQ 2026 pour nettoyer les disques Docker en toute sécurité met l’accent sur l’audit avant le nettoyage et la protection des volumes susceptibles de contenir des bases de données. Appliquez cette prudence ici : n’exécutez jamais de commandes de nettoyage général sur un hôte Immich de production avant de connaître le propriétaire de chaque volume et couche.

Configurez la rotation des journaux, gardez les chemins temporaires sur un stockage disposant d’une marge suffisante pour les pics et surveillez aussi bien l’utilisation des inodes que celle de l’espace lorsque de nombreux petits fichiers sont créés. Si un chemin temporaire est saturé, la bonne solution consiste à limiter ou à déplacer ce rôle, pas à supprimer des répertoires inconnus jusqu’à ce que l’application démarre enfin.

Valider les modifications de stockage avec des tests de redémarrage, de reconstruction et d’espace libre

Après avoir modifié les chemins, ouvrez des fichiers anciens et récents, parcourez plusieurs albums, lisez une vidéo, exécutez une tâche de génération de vignettes ou d’apprentissage automatique, puis téléversez un nouveau fichier de test. Vérifiez que les écritures se font sur les appareils prévus et que la base de données référence toujours des médias lisibles.

Redémarrez les conteneurs, puis l’hôte. Une configuration valide remonte automatiquement chaque rôle, conserve les dérivés attendus et le cache de modèles, garde l’espace temporaire jetable et indique suffisamment d’espace libre sur chaque niveau actif. Surveillez le stockage pendant une période d’utilisation normale pour vérifier que la croissance se produit là où prévu.

Annulez une modification de chemin si Immich crée des répertoires en double, signale des fichiers manquants ou écrit discrètement dans la couche du conteneur en raison d’un échec de montage. Pour remonter le problème, fournissez les correspondances des montages, la taille des chemins, les propriétaires, l’espace libre du système de fichiers, l’utilisation du disque par les conteneurs et le nom exact de la tâche qui a commencé à écrire au mauvais endroit.

Assistance et conseils

À lire aussi

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.