# 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 :

```text
http://ADRESSE_TRUENAS:30041
```

Vérifier depuis le shell :

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

## Journaux

Découvrir les noms :

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

Puis :

```bash
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 :

```text
/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/`