13_Immich
Immich-SERVER
High performance self-hosted photo and video management solution.
Ports
| Hote | Container | IP |
| 8212 | 2283/tcp | 0.0.0.0 |
| 8212 | 2283/tcp | :: |
Volumes
| Source (hote) | Destination | Type | Mode |
/home/debian/docker/immich/upload | /data | bind | rw |
/etc/localtime | /etc/localtime | bind | ro |
/home/debian/docker/immich/upload/encoded-video | /mnt/media/encoded-video | bind | rw |
/home/debian/photo | /mnt/media/photo | bind | ro,shared |
Immich-MICROSERVICES
High performance self-hosted photo and video management solution.
Volumes
| Source (hote) | Destination | Type | Mode |
/home/debian/docker/immich/upload | /data | bind | rw |
/etc/localtime | /etc/localtime | bind | ro |
/home/debian/docker/immich/upload/encoded-video | /mnt/media/encoded-video | bind | rw |
/home/debian/photo | /mnt/media/photo | bind | ro,shared |
Immich-LEARNING
High performance self-hosted photo and video management solution.
Volumes
| Source (hote) | Destination | Type | Mode |
/home/debian/docker/immich/cache | /cache | bind | rw |
Immich-REDIS
Volumes
| Source (hote) | Destination | Type | Mode |
| | /data | volume | rw |
Immich-DB
Base images for Immich containers
Volumes
| Source (hote) | Destination | Type | Mode |
/home/debian/docker/immich/db | /var/lib/postgresql/data | bind | rw |
Integration Claude Code — MCP
| Statut MCP | MCP actif |
| Outils (prefix) | mcp__immich__ |
| Configuration | Script Python : C:\Users\eliob\.claude\mcp_immich.py | Auth : JWT via POST /api/auth/login |
Outils disponibles
get_assets
get_asset
search_assets
update_asset
get_albums
get_album
create_album
get_people
get_person_assets
get_memories
get_statistics
get_my_user
get_server_info
Ce que nous pouvons faire ensemble
- Rechercher des photos par date, lieu, contenu ou personne reconnue
- Parcourir les albums et les souvenirs générés automatiquement
- Consulter les statistiques de la photothèque (nb photos, vidéos, taille)
- Créer un album et y regrouper des assets
- Mettre à jour les métadonnées d'un asset (description, date, lieu)
Sauvegarde de la base de données
Sauvegarde automatique quotidienne de la base PostgreSQL Immich-DB vers kDrive Infomaniak. Mise en place le 2026-06-01.
Paramètres
| Script | /opt/backups/vps_backup.sh |
| Cron | Tous les jours à 2h du matin (0 2 * * *) |
| Container DB | Immich-DB (PostgreSQL 16) |
| Commande | pg_dump -U postgres |
| Taille base (disque) | ~7.5 Mo (métadonnées uniquement — photos sur volume séparé) |
| Format archive | .7z (compression niveau 5) |
| Destination | kDrive Infomaniak — TOOJUX/jux_vps/immich (dossier ID 1427919) |
| Rétention | 7 jours glissants |
| Nommage fichier | immich_db_YYYY-MM-DD.7z |
Note importante
Cette sauvegarde couvre uniquement les métadonnées (albums, faces, tags, utilisateurs). Les fichiers photos/vidéos sont stockés dans /home/debian/docker/immich/upload et /home/debian/photo — ils ne sont pas inclus dans ce backup.
REX — 2026-06-21 — FUSE cassé après restart rclone-photo
Symptôme
Immich connecté mais aucune photo visible. Logs Immich-SERVER :
WARN [Microservices:LibraryService] Skipping invalid import path: /mnt/media/photo. Reason: Error: ENOTCONN: socket is not connected, stat '/mnt/media/photo'
Cause
Le service rclone-photo.service a redémarré le 2026-06-18 (suite à l'incident sécurité du 2026-06-09 — fix --rc-addr 127.0.0.1). Les containers Immich-SERVER et Immich-MICROSERVICES, démarrés avant ce restart, conservent un file descriptor FUSE invalide. La propagation :shared aide pour les nouveaux montages mais ne restaure pas un fd FUSE mort.
Fix immédiat
docker restart Immich-SERVER Immich-MICROSERVICES
# puis déclencher un scan de bibliothèque :
curl -s -X POST "https://immich.juxjux.ovh/api/libraries/89bfcdc1-1604-47a1-90a3-975d2f6c4639/scan" \
-H "Authorization: Bearer TOKEN"
# TOKEN obtenu via POST /api/auth/login (bertrand.dadone@gmail.com / 27101809)
Fix structurel — ExecStartPost dans rclone-photo.service (2026-06-21)
Ajout d'un ExecStartPost dans /etc/systemd/system/rclone-photo.service : à chaque redémarrage de rclone-photo, les containers Immich sont automatiquement relancés si et seulement s'ils tournent déjà (pas de blocage au boot).
ExecStartPost=/bin/bash -c 'sleep 3; docker ps --filter name=Immich-SERVER --filter status=running -q | grep -q . && docker restart Immich-SERVER Immich-MICROSERVICES || true'
Rechargement : sudo systemctl daemon-reload (pas de restart du service nécessaire — prendra effet au prochain redémarrage de rclone-photo).
Library ID Immich
89bfcdc1-1604-47a1-90a3-975d2f6c4639
Inventaire par Claude le 251001