Trace install tas - Immich

Trace install tas - Immich

Rôle

Gestionnaire photo / vidéo.

Accès

• Local : http://10.8.0.1:8088
• Public : https://lololand.hopto.org:25688

Ports

8088 applicatif, 25688 public

Exécution / runtime

Stack docker-compose dans /home/loic/immich/docker-compose.yml ; conteneurs immich_server, immich_microservices, immich_machine_learning, immich_redis, immich_postgres.

Rôle des conteneurs :

• `immich_server` : API / frontend principal exposé localement sur 8088
• `immich_microservices` : traitements de fond Immich
• `immich_machine_learning` : inférence et reconnaissance, ici avec accélération ROCm
• `immich_redis` : broker/cache Redis
• `immich_postgres` : base PostgreSQL/pgvector

Chemins de configuration

• /home/loic/immich/docker-compose.yml
• /home/loic/immich/.env si présent

Le `.env` est critique s'il porte des variables comme :

• `UPLOAD_LOCATION`
• `DB_DATA_LOCATION`
• `IMMICH_VERSION`
• éventuels paramètres GPU / ROCm ou mots de passe de base

Volumes / persistance

• `${UPLOAD_LOCATION}` -> `/usr/src/app/upload`

 * photos, vidéos, vignettes et contenus applicatifs liés aux médias

• `${DB_DATA_LOCATION}` -> `/var/lib/postgresql/data`

 * données PostgreSQL/pgvector

• `/home/loic/immich/ml-cache` -> `/cache`

 * cache du service machine learning

Dépendances

• redis
• postgres pgvector
• machine learning ROCm
• Caddy 25688 -> 8088

Procédure de relance / diagnostic

Relance standard :

• relancer la stack compose Immich depuis /home/loic/immich

Vérifications utiles :

• vérifier que `immich_server` est exposé sur 8088
• vérifier l'état de `immich_postgres` avant toute conclusion sur une panne applicative
• vérifier `immich_machine_learning` séparément si les fonctions IA posent problème
• tester l'accès local avant le proxy Caddy

Points à surveiller :

• si les volumes changent de chemin dans `.env`, la restauration ou la sauvegarde devient incorrecte si la page n'est pas mise à jour
• le cache ML peut être reconstruit, mais sa présence peut améliorer les redémarrages

Remarques

Architecture multi-conteneurs avec accélération ROCm pour la partie machine learning.

Données / emplacements à sauvegarder

• Photos/vidéos : `${UPLOAD_LOCATION}`
• Base Postgres : `${DB_DATA_LOCATION}`
• Cache ML : /home/loic/immich/ml-cache
• fichiers de définition : docker-compose.yml et `.env`

Sauvegarde

• Sauvegarder `${UPLOAD_LOCATION}`, `${DB_DATA_LOCATION}` et /home/loic/immich/ml-cache.
• Sauvegarder /home/loic/immich/docker-compose.yml et le `.env` associé.
• Pour une restauration cohérente, conserver les valeurs exactes des variables de chemin au moment de la sauvegarde.

Restauration

• Restaurer les répertoires d'upload, la base Postgres et le cache ML si souhaité.
• Restaurer `docker-compose.yml` et `.env`.
• Relancer ensuite la stack Immich complète et vérifier séparément le frontend, la base et la partie machine learning.

Maintenance documentaire

Lors d'un changement de volumes photo, base, cache ML, variables `.env`, accélération GPU ou version `IMMICH_VERSION`, mettre à jour cette page.

Trace documentaire

Cette page fait partie de Trace install tas.\n\n== Migration Quadlet confirmée — 2026-07-25 ==

Immich est désormais géré par Quadlet ; l'ancien déploiement Compose a été retiré du runtime.

• Services : immich-postgres.service, immich-redis.service, immich-server.service, immich-microservices.service et immich-machine-learning.service
• Réseau : immich.network
• Application : port local 8088, domaine https://immich.lololand.org/ et accès alternatif https://lololand.hopto.org:25688/
• Données : /home/loic/immich/photos et base PostgreSQL sous /home/loic/immich/db
• Une base PostgreSQL reconstruite proprement a été utilisée après récupération contrôlée ; l'ancienne copie corrompue n'est plus le chemin actif.
• Fichiers Quadlet : /home/loic/.config/containers/systemd/immich-*.container