Skip to main content

3.2 - Installer et configurer l'application

Installer l'application

  1. Ouvrir Apps.
  2. Cliquer sur Discover Apps.
  3. Rechercher Immich.
  4. Ouvrir l'application puis cliquer sur Install.

La méthode TrueNAS est une contribution communautaire intégrée à la documentation Immich. Elle doit être maintenue via le catalogue TrueNAS, pas en modifiant les fichiers générés du projet Compose.

Paramètres principaux

Paramètre Exemple
Nom immich
Fuseau horaire Europe/Paris
Port Web 30041 par défaut sur l'application TrueNAS
Stockage de données /mnt/HDD_DATA_TRUENAS/IMMICH/data
Stockage PostgreSQL /mnt/HDD_DATA_TRUENAS/IMMICH/pgData
Machine learning activé si les ressources le permettent

Dans le conteneur, les données doivent être montées à l'emplacement attendu par l'application, généralement /data.

Ressources

La documentation TrueNAS indique au moins 6 Go de mémoire pour Immich et recommande davantage avec le machine learning. Pour une bibliothèque importante :

  • 4 à 8 threads CPU selon les ressources du serveur ;
  • 8 Go de mémoire ou davantage ;
  • base sur SSD si disponible ;
  • GPU configuré seulement après un fonctionnement correct sur CPU.

Les limites CPU et mémoire ne sont pas des réservations. Éviter de priver TrueNAS et ZFS de mémoire.

Premier démarrage

Une fois l'état Running, ouvrir :

http://ADRESSE_TRUENAS:30041

Vérifier depuis le shell :

sudo docker ps --format 'table {{.Names}}\t{{.Image}}\t{{.Status}}' | grep -i immich
sudo ss -ltnp | grep 30041

Journaux

Découvrir les noms :

sudo docker ps -a --format '{{.Names}} {{.Image}} {{.Status}}' | grep -i immich

Puis :

sudo docker logs --tail 200 NOM_CONTENEUR

Ton installation observée exposait le port interne 2283 sur le port hôte 30041 et utilisait un projet Compose nommé ix-immich.

Modifier les paramètres

Utiliser Apps > Installed Applications > Immich > Edit. TrueNAS recrée ensuite les conteneurs. Ne pas modifier durablement :

/mnt/.ix-apps/app_configs/immich/versions/.../templates/rendered/

Ces fichiers peuvent être écrasés lors d'une mise à jour ou d'un redéploiement.

Référence : https://docs.immich.app/install/truenas/