HowTo : OpenMediaVault - Installer PhotoPrism via Docker sur le Raspberry Pi

PhotoPrism est un logiciel très cool que vous pouvez utiliser pour gérer votre collection de photos localement.

Une fois configurées, vos photos seront numérisées et classées à l'aide de modèles d'IA. Cela signifie que vous ne pouvez pas seulement regarder les photos triées par personne (grâce à la reconnaissance faciale). Il est également possible d'afficher toutes les photos de plage, toutes les photos montrant des voitures, des animaux ou encore des parapluies.

Étant donné que toutes les photos et données utilisateur restent sur votre propre disque dur, vous n'avez pas à vous soucier des soucis habituels comme la protection des données ou le cloud.

Ce que je trouve personnellement très utile, c'est que PhotoPrism peut également fonctionner en mode lecture seule. Si ce mode est activé, PhotoPrism ne lit que vos photos. Cela garantit qu'aucune photo ne peut être modifiée ou supprimée via l'interface PhotoPrism. Si vous voulez ce dernier, vous pouvez bien sûr désactiver la protection en écriture. Ensuite, les photos peuvent non seulement être supprimées et modifiées. Il est également possible de télécharger de nouvelles photos via l'interface ou WebDAV.

Si vous souhaitez tester une démo en direct à l'avance. Les développeurs fournissent une démo sous le lien suivant.

• Démo en direct de PhotoPrism : https://demo.photoprism.app/library/browse

Sur la gauche, vous pouvez voir la vue typique de l'interface PhotoPrism.

Grâce à l'image Docker préparée, l'installation sur le RaspberryPi est rapide et sûre. Il n'y a qu'un petit inconvénient ici : PhotoPrism ne fonctionne que sur un système d'exploitation 64 bits. Vous devrez peut-être installer un système d'exploitation RaspberryPi 64 bits sur la carte SD de votre RaspberryPi.

Dès que vous avez fait cela, vous pouvez commencer. J'ai décrit tout ce que vous devez savoir étape par étape dans cet article.

Consignes de sécurité

Je sais que les notes suivantes sont toujours un peu ennuyeuses et semblent inutiles. Malheureusement, de nombreuses personnes qui savaient "mieux" ont perdu des yeux, des doigts ou d'autres choses à cause d'une négligence ou se sont blessées. La perte de données est presque négligeable en comparaison, mais même celles-ci peuvent être vraiment ennuyeuses. Par conséquent, veuillez prendre cinq minutes pour lire les consignes de sécurité. Parce que même le projet le plus cool ne vaut pas une blessure ou d'autres problèmes.
https://www.nerdiy.de/sicherheitshinweise/

Liens d'affiliation/publicitaires

Les liens vers des boutiques en ligne répertoriés ici sont des liens dits d'affiliation. Si vous cliquez sur un tel lien d'affiliation et effectuez un achat via ce lien, Nerdiy.de recevra une commission de la boutique en ligne ou du fournisseur concerné. Le prix ne change pas pour vous. Si vous effectuez vos achats via ces liens, vous aidez Nerdiy.de à pouvoir proposer d'autres projets utiles à l'avenir. 🙂 

Conditions préalables

Avant de commencer cet article, vous devez avoir préparé le Raspberry Pi pour qu'il soit accessible via le réseau et contrôlé via SSH.

Les articles suivants décrivent ce qu'il faut faire pour préparer votre Raspberry Pi :

• RaspberryPi - configuration pour les nerdiys !
• RaspberryPi – La première configuration !
• RaspberryPi - Contrôlez le RaspberryPi via SSH
• Raspberry Pi - Construisez vous-même NetworkAttachedStorage / NAS avec un Raspberry Pi 4
• RaspberryPi - Construisez vous-même NetworkAttachedStorage / NAS à partir d'un RaspberryPi 4
• RaspberryPi - Installez OpenMediaVault / OMV sur le RaspberryPi

Dans les listes suivantes, vous trouverez toutes les pièces dont vous avez besoin pour mettre en œuvre cet article.

Outil requis :

Matériel requis :

Installer Docker

PhotoPrism est installé en tant qu'image Docker. Pour cela, Docker et Portainer doivent déjà être installés.

Si vous n'avez pas encore installé ces deux outils : Dans l'article Raspberry Pi - Utilisation de conteneurs Docker avec OpenMediaVault OMV et Portainer J'ai décrit l'installation.

Créer un utilisateur OMV System pour exécuter PhotoPrism

Pour exécuter PhotoPrism, vous devez créer un utilisateur.

D'une part, j'ai comment vous le faites dans l'article OpenMediaVault - Créer un autre utilisateur décrit. D'autre part, il est également affiché à nouveau dans les étapes suivantes.

Pour cela, cliquez dans la rubrique

• Utilisateurs

à l'entrée

• Utilisateurs

Clique ensuite sur le symbole plus bleu affiché, puis sur "Create".

Vous pouvez entrer toutes les informations de l'utilisateur dans le formulaire qui s'affiche.

Dans la plupart des cas, il suffit d'attribuer un nom d'utilisateur et un mot de passe. Bien sûr, vous pouvez également configurer d'autres paramètres (par exemple, l'appartenance à un groupe) ici.

J'ai juste l'utilisateur ici

• photoprisme_bot

créé.

Clique ensuite sur "Save" pour valider les paramètres.

Vous pouvez maintenant accepter la modification de la configuration en cliquant sur la coche affichée dans la barre jaune supérieure et en confirmant en cliquant sur "Yes".

Découvrez l'ID utilisateur du système

Plus tard, lors de la configuration de l'image Docker, vous aurez besoin, entre autres, de l'identifiant de l'utilisateur précédemment créé. Vous pouvez y accéder via un accès SSH à votre Raspberry Pi (ou à toute autre machine Linux).

L'ID utilisateur de l'utilisateur

• photoprisme_bot

vous pouvez ensuite le récupérer avec la commande suivante :

• identifiant photoprism_bot

Notez ensuite la valeur de "uid". (Dans cet exemple, "1003").

Créez des dossiers pour stocker les fichiers PhotoPrism

Diverses données utilisateur telles que des bases de données ou des vignettes sont générées pendant le fonctionnement de PhotoPrism. Pour que ceux-ci ne soient pas perdus même après un redémarrage, vous devez maintenant créer un dossier pour eux sur le disque dur connecté à votre OMV.

Aller à la catégorie

• dossiers partagés

Cliquez maintenant sur le symbole plus pour créer un nouveau partage.

Vous serez alors redirigé vers le formulaire affiché.

Ici, vous pouvez donner un nom à la version, sélectionner sur quelle partition intégrée elle doit être créée et également spécifier les droits d'accès.

J'ai choisi ici le nom "photoprism_files". Mais vous pouvez bien sûr donner un autre nom au dossier.

Une fois que vous avez tout défini comme vous le souhaitez, vous pouvez accepter les paramètres en cliquant sur "Enregistrer".

Ensuite, vous devez à nouveau confirmer la configuration modifiée en cliquant sur la coche dans la zone jaune et...

... cela s'est encore confirmé.

Ensuite, tu dois encore configurer les droits d'utilisateur pour ce dossier. Pour ce faire, sélectionnez l'entrée du dossier créé et cliquez sur "Privilèges".

Cherche dans la liste qui s'affiche l'utilisateur créé précédemment (ici "photoprism_bot") et active les droits de lecture et d'écriture ("Read/Write").

Clique ensuite sur "Save" pour enregistrer les modifications.

Maintenant, répétez la même chose pour les paramètres ACL.

Sélectionne le dossier et clique sur l'icône "ACL" affichée.

Activez à nouveau l'accès en lecture et en écriture.

Et définit les configurations restantes comme indiqué.

Clique ensuite à nouveau sur "Save" pour accepter les modifications.

Ensuite, vous devez à nouveau confirmer la configuration modifiée en cliquant sur la coche dans la zone jaune et...

... cela s'est encore confirmé.

À ce stade, vous devez également copier le chemin absolu vers le dossier que vous venez de créer. Vous en aurez besoin plus tard pour l'ajouter au fichier de configuration de Docker Compose

Configurer la configuration de PhotoPrism Docker Compose à l'aide de Portainer

Après avoir préparé tous les dossiers, vous pouvez maintenant configurer PhotoPrism Docker Image à l'aide de la configuration Docker Compose.

Pour ce faire, ouvrez l'interface de votre instance Portainer et cliquez sur le bouton "loal" affiché.

Clique ensuite sur "Stacks".

Puis sur le bouton "+ Add Stack".

Dans l'aperçu "Create Stack", vous devez d'abord attribuer un nom. Par exemple

• photoprisme

Il s'agit maintenant d'adapter la configuration de Docker Compose à vos besoins. Pour ce faire, copiez tout d'abord l'intégralité du texte ci-dessous et collez-le dans le grand champ de texte de l'interface "Create Stack".

Dans les étapes suivantes, les points importants sont ensuite ajustés.

version : '3.5' # Exemple de fichier de configuration Docker Compose pour PhotoPrism (Raspberry Pi 3/4 et autres appareils basés sur ARM64) # # Remarque : # - Vous devez démarrer votre Raspberry Pi 3/4 avec le paramètre "arm_64bit=1" dans config.txt pour utiliser notre image ARM64 (64 bits). # Une erreur "format exec" se produira sinon. # - Essayez d'extraire explicitement la version ARM64 si vous avez démarré votre appareil avec le drapeau "arm_64bit=1" et que vous voyez # l'erreur "no matching manifest" sur Raspberry Pi OS (Raspbian). Voir la documentation pour plus de détails. # - Utilisez https://dl.photoprism.app/docker/armv7/docker-compose.yml pour exécuter PhotoPrism et MariaDB sur des appareils ARMv7 # ainsi que des installations Raspberry Pi OS (Raspbian) sans prise en charge 64 bits. # - Le transcodage matériel n'est disponible que pour les sponsors en raison de l'effort élevé de maintenance et d'assistance. # - L'exécution de PhotoPrism sur un serveur avec moins de 4 Go d'espace de swap ou la définition d'une limite de mémoire/swap peut provoquer des redémarrages inattendus de # ("plantages"), par exemple, lorsque l'indexeur a temporairement besoin de plus de mémoire pour traiter des fichiers volumineux. # - Si vous voyez des erreurs Docker liées à "cgroups", essayez d'ajouter les paramètres suivants à /boot/firmware/cmdline.txt # ou /boot/cmdline.txt (l'emplacement du fichier dépend du système d'exploitation utilisé) : cgroup_enable=cpuset cgroup_enable=memory cgroup_memory=1 # - Si vous installez PhotoPrism sur un serveur public en dehors de votre réseau domestique, veuillez toujours l'exécuter derrière un proxy inverse HTTPS # sécurisé tel que Traefik ou Caddy. Sinon, vos fichiers et mots de passe seront transmis # en texte clair et peuvent être interceptés par n'importe qui, y compris votre fournisseur, les pirates et les gouvernements : # https://docs.photoprism.app/getting-started/proxies/traefik/ # # Setup Guides : # - https://docs.photoprism.app/getting-started/docker-compose/ # - https://docs.photoprism.app/getting-started/raspberry-pi/ # # Listes de contrôle de dépannage : # - https https://docs.photoprism.app/getting-started/troubleshooting/ # - https://docs.photoprism.app/getting-started/troubleshooting/docker/ # - https://docs.photoprism.app/getting- started /troubleshooting/mariadb/ # # Commandes CLI : # - https://docs.photoprism.app/getting-started/docker-compose/#command-line-interface # # Toutes les commandes peuvent devoir être préfixées par "sudo" lorsque ne fonctionne pas en tant que root. # Cela pointera le raccourci du répertoire personnel ~ vers /root dans les montages de volume. services: photoprism: ## Utilisez photoprism/photoprism:preview-arm64 pour tester les versions d'aperçu : image: photoprism/photoprism:arm64 depend_on : - mariadb ## N'activez pas les redémarrages automatiques tant que PhotoPrism n'a pas été correctement configuré et testé ! ## Si le service est bloqué dans une boucle de redémarrage, cela indique un problème de mémoire, de système de fichiers, de réseau ou de base de données : ## https://docs.photoprism.app/getting-started/troubleshooting/#fatal-server-errors # redémarrage : à moins d'être arrêté security_opt : - seccomp:unconfined - apparmor:unconfined ports : - "2342:2342" Environnement du port HTTP # (hôte : conteneur) : PHOTOPRISM_ADMIN_USER : "!ENTER_USERNAME_HERE !" Nom d'utilisateur superadmin # PHOTOPRISM_ADMIN_PASSWORD : " !ENTER_PASSWORD_HERE !" # mot de passe superadmin initial (minimum 8 caractères) PHOTOPRISM_AUTH_MODE : "mot de passe" # mode d'authentification (public, mot de passe) PHOTOPRISM_SITE_URL : "http://!ENTER_HOSTNAME_OR_IP_HERE!:2342/" 1URL du serveur TP5T au format "http(s):// domain.name(:port)/(path)" PHOTOPRISM_ORIGINALS_LIMIT : 50000 # limite de taille de fichier pour les originaux en Mo (augmente pour la vidéo haute résolution) PHOTOPRISM_HTTP_COMPRESSION : "gzip" # améliore la vitesse de transfert et l'utilisation de la bande passante (aucun ou gzip) PHOTOPRISM_WORKERS : 2 # limite le nombre de nœuds de calcul d'indexation pour réduire la charge système PHOTOPRISM_LOG_LEVEL : "info" Niveau de journalisation # : trace, débogage, info, avertissement, erreur, fatal ou panique PHOTOPRISM_READONLY : "true" # ne modifie pas le répertoire des originaux (fonctionnalité réduite) PHOTOPRISM_EXPERIMENTAL : "false" # active les fonctionnalités expérimentales PHOTOPRISM_DISABLE_CHOWN : "false" # désactive la mise à jour des autorisations de stockage via chmod et chown au démarrage PHOTOPRISM_DISABLE_WEBDAV : "false" # désactive le WebD intégré Serveur AV PHOTOPRISM_DISABLE_SETTINGS : "false" # désactive les paramètres dans l'interface utilisateur Web PHOTOPRISM_DISABLE_TENSORFLOW : "false" # désactive toutes les fonctionnalités en fonction de TensorFlow PHOTOPRISM_DISABLE_FACES : "false" # désactive la détection et la reconnaissance des visages (nécessite TensorFlow) nécessite TensorFlow) PHOTOPRISM_DISABLE_RAW : "false" # désactive l'indexation et la conversion des fichiers RAW PHOTOPRISM_RAW_PRESETS : "false" # permet d'appliquer des préréglages utilisateur lors de la conversion des fichiers RAW (réduit les performances) et vignettes (25-100) PHOTOPRISM_DETECT_NSFW : "false" # signale automatiquement les photos comme privées qui PEUVENT être offensantes (nécessite TensorFlow) PHOTOPRISM_UPLOAD_NSFW : "true" # autorise les téléchargements qui PEUVENT être offensants # PHOTOPRISM_DATABASE_DRIVER : "sqlite" qui ne nécessite pas de service r PHOTOPRISM_DATABASE_DRIVER : "mysql" # utilise MariaDB 10.5+ ou MySQL 8+ au lieu de SQLite pour de meilleures performances PHOTOPRISM_DATABASE_SERVER : "mariadb:3306" # Serveur de base de données MariaDB ou MySQL (nom d'hôte : port) name PHOTOPRISM_DATABASE_USER : "photoprism" # Nom d'utilisateur de la base de données MariaDB ou MySQL PHOTOPRISM_DATABASE_PASSWORD : "non sécurisé" # Mot de passe de l'utilisateur de la base de données MariaDB ou MySQL ## Exécuter/installer au premier démarrage (options : mise à jour, gpu, tensorflow, davfs, nettoyage) : #PHOTOPRISM_INIT : "mise à jour propre" ## Transcodage vidéo matériel : # PHOTOPRISM_FFMPEG_ENCODER : "raspberry" "nvidia", "apple", "raspberry") # PHOTOPRISM_FFMPEG_BITRATE : "32" # Limite de débit d'encodage FFmpeg en Mbit/s (valeur par défaut ult : 50) ## Exécuter en tant qu'utilisateur non root après l'initialisation (pris en charge : 0, 33, 50-99, 500-600 et 900-1200) : PHOTOPRISM_UID : 10XX PHOTOPRISM_GID : 100 # PHOTOPRISM_UMASK : 0000 ## Partager des périphériques matériels avec FFmpeg et TensorFlow (facultatif) : ## Voir : https://www.raspberrypi.com/documentation/accessories/camera.html#driver-differences-when-using-libcamera-or-the-legacy-stack Appareils # : # - "/ dev/video11:/dev/video11" # Video4Linux Video Encode Device (h264_v4l2m2m) working_dir : "/photoprism" # ne modifiez ni ne supprimez les dossiers de stockage ## : "~" est un raccourci pour votre répertoire personnel, "." pour les volumes de répertoires actuels : # "/host/folder:/photoprism/folder" # Exemple - "!real_photoLocationFolder1_path!:/photoprism/originals/photoLocation1" # Fichiers multimédia originaux (NE PAS SUPPRIMER) - "!real_photoLocationFolder2_path!:/photoprism /originals/photoLocation2" # Fichiers multimédias originaux (NE PAS SUPPRIMER) - "!real_photoLocationFolderX_path!:/photoprism/originals/photoLocationX" # Fichiers multimédias originaux (NE PAS SUPPRIMER) # - "/example/family:/photoprism/originals/family " # *Des dossiers multimédias supplémentaires* peuvent être montés comme ceci # - "~/Import:/photoprism/import" # Dossier de base *facultatif* à partir duquel les fichiers peuvent être importés vers les originaux - "!real_photoprism_folder_path!/storage:/photoprism/storage " # Dossier de stockage *inscriptible* pour le cache, la base de données et les fichiers annexes (NE PAS SUPPRIMER) ## Serveur de base de données (recommandé) ## voir https://docs.photoprism.app/getting-started/faq/#should-i-use- sqlite-mariadb-or-mysql mariadb : ## Si MariaDB obtient stu ck dans une boucle de redémarrage, cela indique un problème de mémoire ou de système de fichiers : ## https://docs.photoprism.app/getting-started/troubleshooting/#fatal-server-errors restart : image à moins d'être arrêté : arm64v8/mariadb:10.10 IMAGE # ARM64 UNIQUEMENT, NE FONCTIONNE PAS SUR ARMv7, AMD ou Intel security_opt : - seccomp:unconfined - apparmor:unconfined commande : mysqld --innodb-buffer-pool-size=256M --transaction-isolation=READ-COMMITTED --character - set-server=utf8mb4 --collation-server=utf8mb4_unicode_ci --max-connections=512 --innodb-rollback-on-timeout=OFF --innodb-lock-wait-timeout=120 ## Ne stockez jamais les fichiers de base de données sur un périphérique tel qu'un lecteur flash USB, une carte SD ou un dossier réseau partagé : volumes : - "!real_photoprism_folder_path!/database:/var/lib/mysql" # DO NOT REMOVE environnement : MARIADB_AUTO_UPGRADE : "1" MARIADB_INITDB_SKIP_TZINFO : "1 " MARIADB_DATABASE : "photoprisme" MARIADB_USER : "photoprisme" MARIADB_PASSWORD : "non sécurisé" MARIADB_ROOT_PASSWORD : "non sécurisé" ## Watcht ower met à jour les services automatiquement (facultatif) ## voir https://docs.photoprism.app/getting-started/updates/#watchtower # # watchtower : # redémarrage : sauf si arrêté # image : containerrrr/watchtower # environnement : # WATCHTOWER_CLEANUP : "true " # WATCHTOWER_POLL_INTERVAL : 7200 # vérifie les mises à jour toutes les deux heures # volumes : # - "/var/run/docker.sock:/var/run/docker.sock" # - "~/.docker/config.json:/config .json" # facultatif, pour l'authentification si vous avez un compte Docker Hub

Vous devez d'abord entrer un nom d'utilisateur et un mot de passe dans les zones marquées en rouge. Cela sera nécessaire plus tard pour pouvoir se connecter à l'interface Web de PhotoPrism.

Vous devez également entrer le nom d'hôte ou l'adresse IP de votre serveur OMV.

Pour référence, sur mon serveur de test, le fichier ressemble à celui indiqué. (Bien sûr, vous devriez utiliser un mot de passe beaucoup plus compliqué ici.)

Ajuste également la valeur de "PHOTOPRISM_UID" pour qu'elle corresponde à la valeur de l'identifiant de l'utilisateur créé précédemment (dans cet exemple, "1003").

Ensuite, vous devez encore adapter deux chemins d'accès aux dossiers. D'une part, la valeur pour "!real_photoLocationFolderX_path !" et pour "!real_photoprism_folder_path !"

Pour "!real_photoprism_folder_path !", vous devez utiliser le chemin du dossier créé précédemment pour les données utiles.

Pour "!real_photoLocationFolderX_path !", vous devez insérer le chemin d'accès à votre collection de photos. Si votre collection de photos se trouve par exemple sous "/home/pi/pictures", vous insérez ici exactement ce chemin. Vous pouvez également indiquer ici plusieurs chemins. Veillez alors à adapter le "photolocation1...X" en conséquence.

Pour référence : sur mon serveur de test, la partie du fichier de configuration ressemble à celle indiquée.

Pour "!real_photoprism_folder_path !", vous devez ensuite insérer un peu plus bas le chemin du dossier créé précédemment pour les données utiles.

Pour référence : sur mon serveur de test, la partie du fichier de configuration ressemble à celle indiquée.

Vous devriez utiliser la pièce montrée plus tard...

… changer comme indiqué.

Cela provoque le démarrage automatique du conteneur PhotoPrism dès que le serveur est démarré. Les développeurs de PhotoPrism recommandent expressément de ne le faire que lorsque PhotoPrism fonctionne de manière stable !

Une fois que vous avez tout configuré comme vous le souhaitez, vous pouvez activer la configuration en cliquant sur "Deploy the stack".

Vous pouvez vérifier si PhotoPrism démarre en cliquant sur l'entrée affichée...

... et vérifié l'état des deux conteneurs.

ici, les deux devraient avoir le statut "running".

Dans la deuxième colonne, vous pouvez également voir le port par lequel l'interface Web de PhotoPrism est accessible.

Connectez-vous à l'interface PhotoPrism et commencez à indexer les images

Après avoir démarré le conteneur Docker, vous pouvez maintenant appeler l'interface Web de PhotoPrism et commencer à indexer les images. L'indexation est importante pour numériser et, si nécessaire, catégoriser les images. Selon la taille de votre collection de photos, ce processus peut prendre beaucoup de temps (par exemple plusieurs jours).

Pour ouvrir l'interface PhotoPrism, entrez simplement l'adresse IP de votre serveur OMV suivie du port configuré.

Si l'adresse IP de votre serveur OMV est "192.168.0.3" et que vous avez utilisé le port préconfiguré ci-dessus (2342), vous devez donc entrer "192.168.0.3:2342" dans la barre d'adresse de votre navigateur pour ouvrir l'interface de PhotoPrism.

Après avoir appelé l'interface PhotoPrism, vous serez accueilli par la vue affichée.

Entrez ici les données d'accès précédemment configurées pour vous vérifier.

Étant donné qu'aucune indexation n'a été effectuée auparavant, aucune image ne vous sera affichée à présent.

Cliquez donc sur "Library"...

... pour accéder à la vue affichée.

Ici, vous devriez cocher la case "Complete Rescan" et cliquer sur "Start".

Cela commencera à indexer votre collection de photos.

Vous pouvez également surveiller la progression de l'indexation dans l'onglet "Logs" de la même page.

Le processus d'indexation prend maintenant un certain temps en fonction de la taille de la collection de photos.

Pendant ce temps, vous pouvez consulter les premières photos indexées dans la section "Recherche".

Plus d'articles liés à OpenMediaVault

J'ai décrit les nombreuses autres fonctions d'OpenMediaVault dans d'autres articles. Ces articles sont tous regroupés dans la catégorie suivante.

• https://nerdiy.de/category/raspberry-pi/open-media-vault/

Amusez-vous avec le projet

J'espère que tout a fonctionné comme décrit. Si ce n'est pas le cas ou si vous avez des questions ou des suggestions, faites-le moi savoir dans les commentaires. Je les ajouterai à l'article si nécessaire.
Les idées de nouveaux projets sont toujours les bienvenues. 🙂

PS Beaucoup de ces projets - en particulier les projets matériels - coûtent beaucoup de temps et d'argent. Bien sûr, je le fais parce que j'aime ça, mais si vous pensez que c'est cool que je partage l'information avec vous, je serais heureux d'un petit don au fonds du café. 🙂