Trace install tas - Immich - Historique des versions

Daneel : Documentation maintenance conteneurs enrichie: dépendances, volumes, relance et paramètres

2026-04-12T17:02:37Z

Documentation maintenance conteneurs enrichie: dépendances, volumes, relance et paramètres

← Version précédente		Version du 12 avril 2026 à 19:02
Ligne 12 :		Ligne 12 :

	== Exécution / runtime ==		== 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		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 ==		== Chemins de configuration ==
	* /home/loic/immich/docker-compose.yml		* /home/loic/immich/docker-compose.yml
	* /home/loic/immich/.env si présent		* /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 ==		== Volumes / persistance ==
	* ${UPLOAD_LOCATION} -> /usr/src/app/upload		* `${UPLOAD_LOCATION}` -> `/usr/src/app/upload`
	* ${DB_DATA_LOCATION} -> /var/lib/postgresql/data		* photos, vidéos, vignettes et contenus applicatifs liés aux médias
	* /home/loic/immich/ml-cache -> /cache		* `${DB_DATA_LOCATION}` -> `/var/lib/postgresql/data`
			* données PostgreSQL/pgvector
			* `/home/loic/immich/ml-cache` -> `/cache`
			* cache du service machine learning

	== Dépendances ==		== Dépendances ==
Ligne 28 :		Ligne 44 :
	* machine learning ROCm		* machine learning ROCm
	* Caddy 25688 -> 8088		* 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 ==		== Remarques ==
	Architecture multi-conteneurs avec accélération ROCm pour la partie machine learning.		Architecture multi-conteneurs avec accélération ROCm pour la partie machine learning.


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

	== Sauvegarde ==		== Sauvegarde ==
	* Sauvegarder ${UPLOAD_LOCATION}, ${DB_DATA_LOCATION} et /home/loic/immich/ml-cache.		* Sauvegarder `${UPLOAD_LOCATION}`, `${DB_DATA_LOCATION}` et /home/loic/immich/ml-cache.
	* Sauvegarder /home/loic/immich/docker-compose.yml et le .env associé.		* 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 ==		== Restauration ==
	* Restaurer les répertoires d'upload, la base Postgres et le cache ML si souhaité.		* Restaurer les répertoires d'upload, la base Postgres et le cache ML si souhaité.
	* Relancer ensuite la stack Immich complète.		* 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 ==		== Maintenance documentaire ==
	Lors d'un changement de volumes photo, base, cache ML ou version IMMICH_VERSION, mettre à jour cette page.		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 ==		== Trace documentaire ==
	Cette page fait partie de [[Trace install tas]].		Cette page fait partie de [[Trace install tas]].

Maintenance script : Phase 3 : sauvegarde, restauration et persistance

2026-03-18T22:48:13Z

Phase 3 : sauvegarde, restauration et persistance

@@ Ligne 31 : / Ligne 31 : @@
 == Remarques ==
 Architecture multi-conteneurs avec accélération ROCm pour la partie machine learning.
 == Maintenance documentaire ==

Maintenance script : Phase 2 : enrichissement documentation

2026-03-18T22:43:34Z

Phase 2 : enrichissement documentation

← Version précédente		Version du 19 mars 2026 à 00:43
Ligne 9 :		Ligne 9 :

	== Ports ==		== Ports ==
	8088 ~~local~~, 25688 public		8088 applicatif, 25688 public

	== Exécution / runtime ==		== Exécution / runtime ==
	Stack ~~Immich avec server~~, ~~microservices~~, ~~postgres~~, ~~redis~~, ML		Stack docker-compose dans /home/loic/immich/docker-compose.yml ; conteneurs immich_server, immich_microservices, immich_machine_learning, immich_redis, immich_postgres

	== ~~Installation /~~ configuration ==		== Chemins de configuration ==
	~~Architecture multi~~-~~conteneurs~~.		* /home/loic/immich/docker-compose.yml
			* /home/loic/immich/.env si présent

			== Volumes / persistance ==
			* ${UPLOAD_LOCATION} -> /usr/src/app/upload
			* ${DB_DATA_LOCATION} -> /var/lib/postgresql/data
			* /home/loic/immich/ml-cache -> /cache

			== Dépendances ==
			* redis
			* postgres pgvector
			* machine learning ROCm
			* Caddy 25688 -> 8088

	== Remarques ==		== Remarques ==
	~~Prévoir~~ la ~~documentation des~~ volumes ~~et de la sauvegarde~~.		Architecture multi-conteneurs avec accélération ROCm pour la partie machine learning.

			== Maintenance documentaire ==
			Lors d'un changement de volumes photo, base, cache ML ou version IMMICH_VERSION, mettre à jour cette page.

	== Trace documentaire ==		== Trace documentaire ==
	Cette page fait partie de [[~~trace~~ install tas]].		Cette page fait partie de [[Trace install tas]].

Maintenance script : Création de la page de trace logicielle

2026-03-18T22:36:08Z

Création de la page de trace logicielle

Nouvelle page

= 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 local, 25688 public

== Exécution / runtime ==
Stack Immich avec server, microservices, postgres, redis, ML

== Installation / configuration ==
Architecture multi-conteneurs.

== Remarques ==
Prévoir la documentation des volumes et de la sauvegarde.

== Trace documentaire ==
Cette page fait partie de [[trace install tas]].

Trace install tas - Immich - Historique des versions

Daneel : Documentation maintenance conteneurs enrichie: dépendances, volumes, relance et paramètres

Maintenance script : Phase 3 : sauvegarde, restauration et persistance

Maintenance script : Phase 2 : enrichissement documentation

Maintenance script : Création de la page de trace logicielle

Daneel : Documentation maintenance conteneurs enrichie: dépendances, volumes, relance et paramètres

Maintenance script : Phase 3 : sauvegarde, restauration et persistance

Maintenance script : Phase 2 : enrichissement documentation

Maintenance script : Création de la page de trace logicielle