📝 Tutoriel complet — Installer Immich sur Ubuntu + OpenMediaVault + Portainer

---

🔥 Pourquoi Immich ?

Immich est une alternative libre et auto-hébergeable à Google Photos, permettant :

Fonction	Immich
Sauvegarde automatique mobile	✔ Android / iOS
Reconnaissance visages / objets	✔ IA intégrée
Cartographie GPS	✔ avec affichage par lieu
Stockage local ou NAS	✔ SMB / NFS supporté
Accès web, multi-appareils	✔ navigateur + app

Idéal pour photographes, familles, stockage longue durée, archives, etc.

---

📂 Architecture du setup

[VM Ubuntu]  → Docker + Portainer → Immich
    │
    ├── /mnt/omv_photos_ro  → Archives existantes (lecture seule)
    └── /mnt/omv_photos_rw  → Dossier "Imich" (nouvelles photos mobile)

[OpenMediaVault / NAS]
    └── Partage SMB : md/Mes images
          ├── Photos historiques
          └── Imich  ← Upload automatique des mobiles

📌 Avantage : Immich ne peut pas modifier/supprimer vos archives.

---

🧩 Pré-requis

✔ Vieux PC ou équivalent
✔ VM Ubuntu 22.04 ou Ubuntu Serveur
✔ OMV / NAS accessible en SMB
✔Docker & Portainer installé
✔ Dossier partagé existant : \\NAS\Mes images

---

1️⃣ Monter le partage du NAS sous Ubuntu

Installer CIFS :

sudo apt update && sudo apt install -y cifs-utils

Créer les points de montage :

sudo mkdir -p /mnt/omv_photos_ro /mnt/omv_photos_rw

Créer les credentials :

sudo bash -c 'cat >/etc/samba-credentials <<EOF
username=TON_UTILISATEUR
password=TON_MOTDEPASSE
EOF'

sudo chmod 600 /etc/samba-credentials

Montage (IP recommandée) :

sudo mount -t cifs "//192.168.x.x/md/Mes images" /mnt/omv_photos_ro -o credentials=/etc/samba-credentials,ro
sudo mount -t cifs "//192.168.x.x/md/Mes images/Imich" /mnt/omv_photos_rw -o credentials=/etc/samba-credentials,rw

Test :

ls /mnt/omv_photos_ro
ls /mnt/omv_photos_rw

---

2️⃣ Montage auto au démarrage

Dans /etc/fstab :

//192.168.x.x/md/Mes\040images      /mnt/omv_photos_ro cifs ro,credentials=/etc/samba-credentials 0 0
//192.168.x.x/md/Mes\040images/Imich /mnt/omv_photos_rw cifs rw,credentials=/etc/samba-credentials 0 0

Appliquer :

sudo mount -a

---

3️⃣ Installation d’Immich via Portainer

Créer le dossier pour PostgreSQL :

sudo mkdir -p /srv/immich/postgres

Dans Portainer → Stacks → Add Stack, coller :

version: "3.9"

services:
  immich-server:
    container_name: immich_server
    image: ghcr.io/immich-app/immich-server:v2
    restart: always
    ports:
      - "2283:2283"
    environment:
      - DB_PASSWORD=ChangeMe12345
      - DB_USERNAME=postgres
      - DB_DATABASE_NAME=immich
      - TZ=Europe/Luxembourg
    depends_on:
      - redis
      - database
    volumes:
      - /mnt/omv_photos_rw:/data
      - /mnt/omv_photos_ro:/mnt/archives:ro
      - /etc/localtime:/etc/localtime:ro

  immich-machine-learning:
    container_name: immich_machine_learning
    image: ghcr.io/immich-app/immich-machine-learning:v2
    restart: always
    environment:
      - DB_PASSWORD=ChangeMe12345
      - DB_USERNAME=postgres
      - DB_DATABASE_NAME=immich
      - TZ=Europe/Luxembourg
    volumes:
      - model-cache:/cache

  redis:
    container_name: immich_redis
    image: docker.io/valkey/valkey:9
    restart: always

  database:
    container_name: immich_postgres
    image: ghcr.io/immich-app/postgres:14-vectorchord0.4.3-pgvectors0.2.0
    restart: always
    environment:
      - POSTGRES_PASSWORD=ChangeMe12345
      - POSTGRES_USER=postgres
      - POSTGRES_DB=immich
      - POSTGRES_INITDB_ARGS=--data-checksums
    volumes:
      - /srv/immich/postgres:/var/lib/postgresql/data

volumes:
  model-cache:

💥 Deploy

Interface Immich → http://ip-serveur:2283

---

4️⃣ Configuration d’Immich

Créer la bibliothèque externe

Admin → Bibliothèques externes → Ajouter
Chemin : /mnt/archives

Cliquez Analyser / Scan library

Ajouter l’accès utilisateur

Bibliothèque → Membres → Ajouter utilisateur

→ Les photos apparaissent 🎉

---

📱 Sauvegarde mobile automatique

Installer l’application Immich Android/iOS

Ouvrir app → Connexion → Backup auto : ON
→ Destination = Upload Library (/data)

Chaque photo prise est envoyée directement dans NAS /Imich

---

📌 Troubleshooting / FAQ (important)

Problème	Solution
Immich vide	External library non créée → ajouter /mnt/archives
“denied ghcr.io/v2/…”	Microservices supprimé → utiliser stack v2 ci-dessus
Photos non visibles	L’utilisateur doit être ajouté à la bibliothèque
CIFS pas monté	tester mount -a + vérifier mot de passe SMB
Nom NAS ne fonctionne pas	Utiliser l’IP : //192.168.x.x

---

🏁 Conclusion

Vous disposez maintenant :

✔ d’un Google Photos self-hosted
✔ avec stockage illimité (NAS)
✔ accès web + mobile
✔ reconnaissance IA
✔ sauvegarde automatique smartphone