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.