Homelab 7 : remplacer Google Photos par Immich

Niveau DébutantTemps estimé 1 hÀ lire avant Homelab 2 : une seule entrée HTTPS pour tous vos services, Homelab 5 : des sauvegardes qui survivent à une attaque de votre serveurUn mot inconnu ? Lexique

Immich est la photothèque open source la plus proche de Google Photos : une app de téléphone qui sauvegarde en arrière-plan, des albums, des liens de partage, une carte, la reconnaissance des visages et la recherche par contenu, le tout calculé sur votre propre machine. C'est aussi le service où une installation négligée perd le plus : des années de photos.

Une photothèque, c'est deux choses : les fichiers, et la base qui connaît albums, visages et dates. Immich exporte la base chaque nuit ; les fichiers, c'est à vous de les copier. L'un sans l'autre ne restaure rien d'utile.

Un peu d'histoire

Immich a été lancé en 2022 par Alex Tran, qui voulait sortir les photos de sa famille d'un cloud commercial sans renoncer à son confort : sauvegarde automatique depuis le téléphone, visages, lieux, recherche par contenu. Il est devenu l'un des projets auto-hébergés les plus actifs, et son développement est financé depuis 2024 pour qu'il reste libre et gratuit.

1. Installer, à la manière officielle

Immich publie son propre fichier compose et son modèle d'environnement à chaque version. Sur une VM avec Docker (Homelab 1), dans un dossier vide :

wget -O docker-compose.yml https://github.com/immich-app/immich/releases/latest/download/docker-compose.yml
wget -O .env https://github.com/immich-app/immich/releases/latest/download/example.env

Puis modifiez .env :

UPLOAD_LOCATION : où vivront vos photos. Un disque avec de la place pour grandir.
DB_DATA_LOCATION : les fichiers de la base, sur un disque local (les partages réseau ne sont pas pris en charge).
DB_PASSWORD : changez-le, lettres et chiffres uniquement.
IMMICH_VERSION : épinglez une version précise, comme le suggère le commentaire du fichier lui-même, et montez de version exprès après avoir lu les notes de version.

docker compose up -d

Publiez-le par votre proxy HTTPS (Homelab 2), créez le compte administrateur, puis installez l'app Immich sur votre téléphone et donnez-lui votre adresse.

2. Les deux choses à sauvegarder

Une photothèque, ce sont les fichiers et la base qui connaît les albums, les visages, les dates et qui a partagé quoi. Immich exporte automatiquement sa base chaque nuit à 2 h et garde les 14 derniers exports, dans UPLOAD_LOCATION/backups. Il ne sauvegarde pas vos fichiers : cette partie est à vous. Copiez tout UPLOAD_LOCATION chaque nuit, vers une autre machine (Homelab 5).

Si vous ne pouvez pas arrêter le serveur pendant la copie, l'ordre officiel est : la base d'abord, les fichiers ensuite.

3. Restaurer, une fois, pour voir

Sur une installation neuve, remettez les anciens fichiers dans le nouveau UPLOAD_LOCATION, lancez Immich, et choisissez Restore from backup sur l'écran d'accueil. Faites-le une fois sur une machine de test avant d'en avoir besoin.

Pièges

Si le dossier des photos est sur un disque séparé monté dans la VM, les sauvegardes de VM de l'hyperviseur ne l'incluent pas. Vérifiez ce que vos sauvegardes contiennent vraiment : la photothèque est souvent la plus grosse, et la moins couverte.

La première passe de reconnaissance des visages et d'indexation d'une grosse photothèque tourne des heures sur le processeur. Laissez-la tourner, ou confiez le conteneur d'apprentissage automatique à une carte graphique.

Sous Android, la sauvegarde en arrière-plan s'arrête si le système endort l'app : excluez Immich de l'optimisation de batterie.

Sources

Utile ? Dites-nous ce qu'il faut mesurer ensuite.