Technical Anshu
Tutorials Blog
📸 Installation Docker Immich

Installez Immich avec Docker pour votre propre cloud de photos privé

Le stockage Google Photos se remplit, les prix augmentent et les souvenirs de votre famille restent sur l'ordinateur de quelqu'un d'autre. Immich met un nuage de photos complet – chronologie, albums, recherche de visage, sauvegarde automatique du téléphone – sur une machine dans votre propre maison. Voici l’installation complète et honnête, dans l’ordre qui fonctionne.

✍️ Technical Anshu🐳 Docker / Linux Server⏱️ 15 minute install
🎥 Regardez la méthode la plus rapide dans la vidéo : installation complète d'Immich Docker, étape par étape

Immich est ce qui se rapproche le plus de Google Photos sur votre propre matériel : votre téléphone sauvegarde automatiquement, les photos apparaissent dans une chronologie claire et vous pouvez effectuer une recherche par visage, lieu ou objet. L'installation est notoirement courte : deux fichiers à télécharger, un fichier à modifier, une commande à exécuter - mais les quelques choix contenus dans ce fichier déterminent si votre bibliothèque est sûre pendant des années ou fragile dès le premier jour. Ce guide fait ces choix avec soin.

Terminal — the whole install is four commands
$ mkdir ./immich-app && cd ./immich-app $ wget -O docker-compose.yml https://github.com/immich-app/immich/releases/latest/download/docker-compose.yml $ wget -O .env https://github.com/immich-app/immich/releases/latest/download/example.env $ docker compose up -d

👆 La route d'installation officielle de la documentation Immich : deux fichiers téléchargés, une commande et le serveur est en ligne.

1

Ce dont vous avez besoin avant de commencer

Immich est une plate-forme de sauvegarde de photos et de vidéos auto-hébergée : pensez à Google Photos, mais le serveur est une machine dans votre propre maison et personne d'autre ne conserve vos photos. Il est gratuit et open source, et le moyen officiel de l'exécuter est Docker Compose sur un serveur Linux, un ancien PC, un mini PC ou un NAS prenant en charge Docker.

  1. Une machine qui reste allumée : un mini PC, un ancien ordinateur de bureau, un serveur domestique ou un NAS. Un ordinateur portable qui dort tous les soirs est un mauvais serveur photo
  2. Docker et Docker Compose installés et fonctionnent – tester avec docker compose version
  3. RAM : environ 4 Go est le minimum pratique ; le conteneur d'apprentissage automatique est la partie la plus affamée, donc 6 à 8 Go sont nettement plus heureux
  4. Stockage : votre photothèque complète, plus environ 10 à 20 % de plus pour les miniatures et les vidéos transcodées. Le stockage – et non le processeur – est ce dont vous manquerez en premier
  5. Attente honnête : Immich est un jeune projet en développement actif. C'est excellent, mais les développeurs eux-mêmes ont toujours conseillé de conserver une autre sauvegarde des photos irremplaçables. Ce guide suit ces conseils partout
2

Téléchargez les deux fichiers officiels

Ne copiez jamais un fichier Docker-compose aléatoire à partir d'un blog ou d'un message de forum - les versions dérivent et le fichier d'un étranger peut vous épingler à une ancienne version. Les fichiers officiels sont toujours en ligne sur la page de publication GitHub du projet :

  1. Créez le dossier : mkdir ./immich-app et déplacez-vous dedans avec cd ./immich-app
  2. Téléchargez le fichier de composition : wget -O docker-compose.yml https://github.com/immich-app/immich/releases/latest/download/docker-compose.yml
  3. Téléchargez le modèle d'environnement : wget -O .env https://github.com/immich-app/immich/releases/latest/download/example.env
  4. Notez le changement de nom dans cette deuxième commande : le modèle s'appelle example.env, mais Docker ne le lit que si le fichier s'appelle exactement .env.
3

Modifiez le fichier .env - la seule configuration qui compte

Le fichier .env contient les quelques valeurs qu'Immich ne peut pas deviner. Ouvrez-le avec nano .env et définissez-les :

  1. UPLOAD_LOCATION=./library — où seront hébergées vos photos et vidéos originales. Pointez-le vers votre disque le plus grand et le plus fiable. Il doit s'agir d'un dossier avec suffisamment d'espace libre pour toute la bibliothèque
  2. DB_DATA_LOCATION=./postgres — où réside la base de données. Conservez-le sur un SSD local. La documentation d'Immich est directe : les partages réseau ne sont pas pris en charge pour la base de données, et l'exécuter sur un seul peut la corrompre.
  3. DB_PASSWORD= — remplacez-le par un long mot de passe aléatoire. Utilisez uniquement des lettres et des chiffres (A-Z, a-z, 0-9) : les caractères spéciaux peuvent interrompre l'analyse du fichier par Docker.
  4. TZ=Asia/Kolkata – décommentez et définissez votre fuseau horaire pour que les dates des photos et les tâches planifiées s'alignent
  5. Laissez IMMICH_VERSION et tout ce qui se trouve en dessous de la ligne marquée seul pour une première installation
4

Démarrez la pile et créez le compte administrateur

  1. Exécutez docker compose up -d — Docker télécharge quatre images de conteneur et les démarre ensemble. La première exécution prend quelques minutes en fonction de votre vitesse Internet
  2. Vérifiez que tout est arrivé avec docker compose ps — vous devriez voir le serveur, l'apprentissage automatique, la base de données et les conteneurs Redis en cours d'exécution
  3. Ouvrez http://YOUR-SERVER-IP:2283 dans un navigateur sur le même réseau. Immich répond sur le port 2283
  4. Cliquez sur l’écran de bienvenue et inscrivez-vous. Le tout premier compte créé devient l'administrateur. Effectuez donc cette étape vous-même, immédiatement, avant que quiconque sur votre réseau ne trouve la page.
  5. À l’intérieur, ouvrez Administration et exécutez les vérifications du stockage et de la bibliothèque. Installez ensuite l'application gratuite Immich sur votre téléphone, connectez-vous avec la même adresse de serveur et activez la sauvegarde automatique.
5

Ce qui vient de commencer : quatre conteneurs, quatre emplois

Le fichier de composition que vous avez téléchargé gère une petite équipe, pas un seul programme :

  1. immich-server — le cerveau. L'interface Web, l'API avec laquelle votre téléphone communique, les téléchargements, les albums, le partage et la recherche
  2. immich-machine-learning — les yeux. La détection des visages, la reconnaissance des visages et la recherche intelligente s'exécutent ici, en arrière-plan
  3. base de données (PostgreSQL) — la mémoire. Le nom, la date, l'album, le visage et les données de recherche de chaque photo se trouvent ici. Les originaux sont des fichiers ; la signification est dans cette base de données
  4. redis — le messager. Il transmet les tâches entre le serveur et les travailleurs en arrière-plan

Connaître cette répartition compte plus tard : si la recherche échoue, vous vérifiez l'apprentissage automatique ; si les photos disparaissent de la chronologie mais que les fichiers sont toujours sur le disque, vous vérifiez la base de données. Le guide compagnon sur cette page décode chaque service dans son intégralité.

6

Les trois règles à suivre dès le premier jour

  1. À lire avant de mettre à jour. Immich publie souvent et certaines versions contiennent des modifications importantes qui nécessitent une étape de mise à niveau spécifique. Deux minutes avec les notes de version valent mieux qu'un week-end de récupération
  2. Sauvegardez la paire, pas seulement les photos. Les fichiers de votre bibliothèque sans la base de données perdent leurs albums, leurs visages et leur organisation. Une vraie sauvegarde couvre à la fois
  3. N'exposez jamais le port brut à Internet. Le port 2283 sur votre réseau domestique convient. Sur Internet ouvert, utilisez un VPN ou un tunnel — le guide d'accès à distance sur cette page explique pourquoi et comment

Suivez ces trois-là et Immich est un cloud privé véritablement fiable. Ignorez-les et le même logiciel devient un avertissement : la différence réside dans les habitudes, pas dans l'outil.

🔴 La note d'honnêteté qu'Immich lui-même donne : le projet est en développement actif et évolue rapidement. Considérez Immich comme votre plateforme photo, et non comme votre seule copie. Conservez une sauvegarde séparée de la bibliothèque et de la base de données – le guide de sauvegarde lié à cette page montre la routine complète.

🎥 Regardez le processus complet dans la vidéo

L'installation complète (configuration du serveur, connexion à l'application téléphonique et première sauvegarde) est présentée en direct dans la vidéo.

▶️ Watch Full Video
❓ Questions fréquemment posées

Immich est-il vraiment gratuit ou existe-t-il un niveau payant ?

Immich est gratuit et open source sous licence AGPL, et le projet s'est engagé à garder toutes les fonctionnalités gratuites – il n'y a pas de niveau payant. Un achat optionnel existe uniquement pour soutenir les développeurs et ne débloque rien. Vos coûts réels sont votre propre matériel et votre électricité.

De quelle quantité de RAM et de stockage Immich a-t-il réellement besoin ?

Prévoyez environ 4 Go de RAM comme base (le conteneur d'apprentissage automatique est la partie la plus gourmande) et un stockage égal à l'ensemble de votre photothèque, plus environ 10 à 20 % supplémentaires pour les vignettes et les vidéos transcodées. Le stockage s’épuise bien avant le processeur.

Puis-je exécuter Immich sur Windows ou un Raspberry Pi ?

La voie officielle prise en charge est Docker sous Linux, qui inclut la plupart des systèmes NAS et des mini PC. Sous Windows, la solution pratique est Docker dans WSL2 ou une petite machine virtuelle Linux. Un Raspberry Pi peut l'exécuter, mais les tâches de reconnaissance faciale et vidéo seront lentes ; un mini PC d'occasion bon marché est une maison beaucoup plus heureuse pour lui.

Ce guide est basé sur la vidéo technique Anshu liée ci-dessus. • Coincé sur une marche ? Demandez dans les commentaires vidéo — c'est là que les réponses arrivent le plus rapidement 🙏