Sélectionner Une Page

Immich – Installation

DOCKER, MEDIAS

Illustration extraite de GitHub-immich

Immich est une solution open source et auto-hébergée de gestion et de sauvegarde de photos et vidéos, conçue comme une alternative moderne aux services cloud propriétaires comme Google Photos, iCloud ou Amazon Photos.

Ce logiciel permet aux utilisateurs de reprendre le contrôle total de leurs données en les stockant sur leur propre matériel (serveur, NAS Synology, Raspberry Pi, etc.). 

Il se distingue par :

  • Une interface fluide et intuitive, similaire à celle des grandes plateformes grand public.
  • Des fonctionnalités avancées incluant la reconnaissance faciale, la détection d'objets par IA, la recherche par métadonnées et le support des fichiers RAW.
  • Une sauvegarde automatique depuis les applications mobiles (Android et iOS) ou l'ordinateur.
  • La version 2.0, publiée en octobre 2025, marque la première version considérée comme stable après plus de 1 300 jours de développement.
  • Le déploiement s'effectue généralement via Docker Compose et nécessite des ressources matérielles modestes (au moins 4 Go de RAM recommandés).
  • Bien que gratuit et libre, il exige une gestion technique par l'utilisateur pour l'installation et la maintenance.

1. Configuration Console

Pour cette application, l'App Store propose Immich par Gallery. La trame de configuration proposée est en adéquation avec les YAML proposés par le développeur (et les communautés).

Pour  finaliser la configuration de cette application, je vous propose quelques modifications optionnelles.

Avec le magasin d'applications

Ouvrez App Store et sur la barre de recherche tapez immich.

Cliquez sur l'icône de l'app proposée par Gallery et sélectionnez sous le bouton Installer > Installation personnalisée

Avec le YAML

Copiez collez le code YAML ci-dessous, pour une installation avec quelques éléments déjà modifés, en important le code (voir méthode sur Mazanoke par exemple)   - ouvrir la bascule.

Avertissement : Vérifiez que votre magasin d'application (plus particulièrement si vous utilisez CasaOS) est à jour et que les versions d'image correspondent à celles proposées sur le site d'Immich. Version ici proposée au 13/04/2026

YAML

Immich

name: immich
services:
  database:
    cpu_shares: 
    command: []
    container_name: immich-postgres
    deploy:
      resources:
        limits:
          memory: 
        reservations:
          devices: []
    environment:
      - POSTGRES_DB=immich
      - POSTGRES_INITDB_ARGS=--data-checksums
      - POSTGRES_PASSWORD=zimaos1234
      - POSTGRES_USER=postgres
      - TZ=Europe/Paris
    hostname: immich-postgres
    image: ghcr.io/immich-app/postgres:14-vectorchord0.4.3-pgvectors0.2.0@sha256:bcf63357191b76a916ae5eb93464d65c07511da41e3bf7a8416db519b40b1c23
    labels:
      icon: https://cdn.jsdelivr.net/gh/IceWhaleTech/CasaOS-AppStore@main/Apps/Immich/icon.png
    restart: unless-stopped
    volumes:
      - type: bind
        source: /DATA/AppData/immich/pgdata
        target: /var/lib/postgresql/data
        bind:
          create_host_path: true
    ports: []
    devices: []
    cap_add: []
    networks:
      - immich
    privileged: false
  immich-machine-learning:
    cpu_shares: 90
    command: []
    container_name: immich-machine-learning
    deploy:
      resources:
        limits:
          memory: 
        reservations:
          devices: []
    environment:
      - DB_DATABASE_NAME=immich
      - DB_PASSWORD=zimaos1234
      - DB_USERNAME=postgres
    hostname: immich-machine-learning
    healthcheck: {}
    image: ghcr.io/immich-app/immich-machine-learning:release
    labels:
      icon: https://cdn.jsdelivr.net/gh/IceWhaleTech/CasaOS-AppStore@main/Apps/Immich/icon.png
    restart: unless-stopped
    volumes:
      - type: bind
        source: /DATA/AppData/immich/model-cache
        target: /cache
        bind:
          create_host_path: true
    ports: []
    devices: []
    cap_add: []
    networks:
      - immich
    privileged: false
  immich-server:
    cpu_shares: 
    command: []
    container_name: immich-server
    depends_on:
      database:
        condition: service_started
        required: true
      redis:
        condition: service_started
        required: true
    deploy:
      resources:
        limits:
          memory: 
        reservations:
          memory: "1073741824"
          devices: []
    devices:
      - /dev/dri:/dev/dri
    environment:
      - DB_DATABASE_NAME=immich
      - DB_PASSWORD=zimaos1234
      - DB_USERNAME=postgres
      - TZ=Europe/Paris
    hostname: immich-server
    healthcheck: {}
    image: ghcr.io/immich-app/immich-server:release
    labels:
      icon: https://cdn.jsdelivr.net/gh/IceWhaleTech/CasaOS-AppStore@main/Apps/Immich/icon.png
    ports:
      - mode: ingress
        target: 2283
        published: "2283"
        protocol: tcp
    restart: always
    volumes:
      - type: bind
        source: /DATA/Gallery/immich
        target: /usr/src/app/upload
        bind:
          create_host_path: true
    cap_add: []
    networks:
      - immich
    privileged: false
  redis:
    cpu_shares: 
    command: []
    container_name: immich-redis
    deploy:
      resources:
        limits:
          memory: 
        reservations:
          devices: []
    hostname: immich-redis
    healthcheck:
      test:
        - CMD-SHELL
        - redis-cli ping || exit 1
    image: docker.io/valkey/valkey:9@sha256:3eeb09785cd61ec8e3be35f8804c8892080f3ca21934d628abc24ee4ed1698f6
    labels:
      icon: https://cdn.jsdelivr.net/gh/IceWhaleTech/CasaOS-AppStore@main/Apps/Immich/icon.png
    restart: always
    ports: []
    volumes: []
    devices: []
    cap_add: []
    environment: []
    networks:
      - immich
    privileged: false
networks:
  immich:
    name: immich_immich
    driver: bridge
x-casaos:
  architectures:
    - amd64
    - arm64
  author: Cp0204
  category: Gallery
  description:
    fr_FR: >
      Immich : Révolutionnez votre expérience multimédia à domicile
      Immich est là pour transformer la façon dont vous gérez et profitez de vos fichiers multimédias sur votre télévision, smartphones et autres appareils. Contrairement aux albums photo traditionnels ou aux services cloud grand public, immich offre une plateforme moderne et fluide pour organiser, partager et accéder à vos photos et vidéos. Imaginez sauvegarder sans effort vos précieux moments depuis vos appareils mobiles et les visualiser instantanément sur votre télévision ou les partager avec vos proches—immich rend tout cela possible.
      Immich se distingue par sa sauvegarde automatique depuis les appareils mobiles, une interface web élégante pour naviguer facilement dans vos contenus, et des fonctionnalités avancées comme la reconnaissance faciale et la détection d'objets. Vous pouvez organiser vos médias par localisation, profiter de la lecture de vidéos en 4K, et même gérer des photos RAW. De plus, avec le support multi-utilisateur, partager des souvenirs avec vos amis et votre famille est un jeu d'enfant. Le meilleur ? Immich propose ces puissantes fonctionnalités à faible coût, vous offrant une expérience premium sans vous ruiner.
      Déployer immich sur un appareil cloud privé comme Zima offre une commodité inégalée. Profitez d'une capacité de stockage illimitée, de vitesses de réseau local ultra-rapides, et d'un accès multi-appareils simplifié. Avec immich sur votre cloud privé Zima, vos médias sont toujours à portée de main, en sécurité chez vous.
  developer: alextran1502
  hostname: 
  icon: https://cdn.jsdelivr.net/gh/IceWhaleTech/CasaOS-AppStore@main/Apps/Immich/icon.png
  index: /
  is_uncontrolled: true
  main: immich-server
  port_map: "2283"
  scheme: http
  screenshot_link:
    - https://cdn.jsdelivr.net/gh/IceWhaleTech/CasaOS-AppStore@main/Apps/Immich/screenshot-1.png
    - https://cdn.jsdelivr.net/gh/IceWhaleTech/CasaOS-AppStore@main/Apps/Immich/screenshot-2.png
    - https://cdn.jsdelivr.net/gh/IceWhaleTech/CasaOS-AppStore@main/Apps/Immich/screenshot-3.png
  store_app_id: immich
  tagline:
    fr_FR: Solution de gestion multimédia auto-hébergée
  title:
    custom: "IMMICH"
    en_us: Immich

Paramètres Immich

Sur l'onglet DATABASE

Web UI : Indiquez votre IP locale (ou NDD:443 si vous utilisez un Proxy Inversé)

POSTGRES_PASSWORD : Changez le mot de passe (lettre et chiffre)

TZ : Europe/Paris (à ajouter - optionnel)

Onglet IMMICH-MACHINE-LEARNING :

Image Tag : release (ou dernière version - optionnel)

DB_PASSWORD : Indiquez le même si changement à "database"

Onglet IMMICH-SERVER

Image Tag : release (ou dernière version - optionnel)

DB_PASSWORD : Indiquez le même si changement à "database"

TZ : Europe/Paris (à ajouter - optionnel)

/etc/localtime > vous pouvez supprimer la ligne (remplacé par TZ)

Périphériques : rajouter si vous avez un CPU Intel (avec iGPU) /dev/dri = /dev/dri (pour les autres CPU voir sur le site)

Installer

Cliquez sur Installer et patientez le temps de l’installation

Puis, cliquez sur la nouvelle tuile créée pour ouvrir une nouvelle page web

2. Configuration Interface

Enregistrez-vous en tant qu'administrateur, puis connectez-vous avec vos nouveaux identifiants.

  • Vous êtes assisté pour vos premiers paramètres
  • Thème : Clair ou Sombre
  • Langue : Choisir dans la liste déroulante
  • Confidentialité : Carte et version activez (ou pas) + Google (activez ou pas)
  • Modèle de stockage activez ou non 
  • Conseils sur la sauvegarde (3-2-1)
  • Liens pour les applications mobiles

Bienvenue sur Immich

  1. Accueil
  2. /
  3. MEDIAS
  4. /
  5. Immich  Installation
morgyann

morgyann

Curieux de nature, j’ai découvert le monde des serveurs et plus particulièrement des applications Docker en apprenant au fil des essais et des ressources partagées sur le web. En retour, je partage ce que je connais et plus particulièrement à l'intention des débutants.

Si vous avez envie de proposer un article, n'hésitez pas à me contacter.

Soutenons l'utilisation des applications open source et leurs développeurs.