Exigences
Exigences matérielles et logicielles pour Immich :
Matériel
- OS : Système d'exploitation Linux ou *nix recommandé (Ubuntu, Debian, etc.).
- Les systèmes d'exploitation non-Linux ont tendance à offrir une mauvaise expérience avec Docker et sont fortement déconseillés.
Notre capacité à aider avec l'installation ou le dépannage sur des systèmes non-Linux sera considérablement réduite.
Si vous voulez tout de même essayer un système non-Linux, vous pouvez le configurer comme suit :
- Windows : Docker Desktop sur Windows ou WSL 2.
- macOS : Docker Desktop sur Mac.
- Immich fonctionne bien dans un environnement virtualisé lorsqu'il s'exécute dans une machine virtuelle complète. L'utilisation de Docker dans des conteneurs LXC n'est pas recommandée, mais peut être possible pour les utilisateurs expérimentés. En cas de problème, nous recommandons de passer à un déploiement VM pris en charge.
- Les systèmes d'exploitation non-Linux ont tendance à offrir une mauvaise expérience avec Docker et sont fortement déconseillés.
Notre capacité à aider avec l'installation ou le dépannage sur des systèmes non-Linux sera considérablement réduite.
Si vous voulez tout de même essayer un système non-Linux, vous pouvez le configurer comme suit :
- RAM : Minimum 4GB, recommandé 6GB.
- CPU : Minimum 2 cœurs, recommandé 4 cœurs.
- Stockage : Filesystem compatible Unix recommandé (EXT4, ZFS, APFS, etc.) avec prise en charge de la propriété et des permissions utilisateur/groupe.
- La génération de vignettes et de vidéos transcodées peut augmenter la taille de la bibliothèque de photos de 10 à 20 % en moyenne.
Des performances optimales et une connexion stable à la base de données Postgres sont essentielles pour une bonne expérience avec Immich.
Les fichiers de la base de données Postgres sont généralement compris entre 1 et 3 GB.
Pour cette raison, la base de données Postgres (DB_DATA_LOCATION) devrait idéalement utiliser un stockage SSD local, et jamais un partage réseau quelconque.
En outre, si des limites de ressources Docker sont utilisées, la base de données Postgres nécessite au moins 2GB de RAM.
Les utilisateurs de Windows peuvent rencontrer des problèmes avec les fichiers systèmes non compatibles Unix ; voir ci-dessous pour plus de détails.
Logiciel
Immich nécessite Docker avec le plugin Docker Compose :
- Docker Engine : Cette variante CLI est conçue pour les serveurs Linux (ou Windows via WSL2).
- Docker Desktop : Cette variante GUI n'est pas recommandée pour Linux, mais est disponible pour Windows ou macOS.
Le plugin Compose sera installé à la fois par Docker Engine et Desktop en suivant les guides d'installation liés ; il peut également être installé séparément.
Immich nécessite la commande docker compose; la commande similaire docker-compose est obsolète et n'est plus prise en charge par Immich.
Exigences spéciales pour les utilisateurs Windows
Stockage de la base de données sur les systèmes Windows
La base de données Postgres Immich (DB_DATA_LOCATION) doit être située sur un système de fichiers prenant en charge la propriété et les permissions utilisateur/groupe (EXT2/3/4, ZFS, APFS, BTRFS, XFS, etc.). Elle ne fonctionne pas sur un système de fichiers formaté en NTFS ou ex/FAT/32.
Elle ne fonctionne pas dans WSL (Windows Subsystem for Linux) lorsqu'elle utilise un répertoire hôte monté (généralement sous /mnt).
Si cela pose problème, vous pouvez changer le montage lié pour un volume Docker comme suit :
Effectuez la modification suivante dans .env :
- DB_DATA_LOCATION=./postgres
+ DB_DATA_LOCATION=pgdata
Ajoutez la ligne suivante en bas de docker-compose.yml :
volumes:
model-cache:
+ pgdata: