Files
wiki/Catalogue-Self-Hosted/apps/app-foldergram.md
T
2026-06-09 18:40:21 +02:00

3.8 KiB


📸 Foldergram

Galerie photos basée sur dossiers, sans import : pointez l'app sur votre arborescence existante et obtenez une galerie web clé en main, sans rien déplacer ni indexer lourdement.

📋 Informations Générales

Attribut Valeur
Nom Foldergram
Slug app-foldergram
Description Galerie web générée depuis une arborescence de dossiers
Site officiel foldergram.app
Repository foldergram/foldergram
Stars 433
Licence MIT
Langage principal TypeScript, Node.js
Catégorie Photos
Tags [catalogue, photos, gallery, folder, simple, self-hosted, web]

📝 Description

Foldergram part d'un constat simple : vous avez déjà vos photos bien rangées dans des dossiers (par date, événement, voyage). Pourquoi les importer dans une nouvelle base, créer des albums virtuels, gérer une BDD ? Foldergram lit directement votre arborescence et en fait une galerie web navigable, avec le dossier = album.

C'est l'anti-Immich dans l'approche : zéro import, zéro duplication, zéro base de données centrale. L'app scanne votre dossier, génère des thumbnails à la volée, et présente une UI web qui reflète votre structure.

Fonctionnalités : scan récursif de l'arborescence, dossiers = albums automatiques, thumbnails générés à la volée (cache disque), tri chronologique (par EXIF ou mtime), carte géographique (si EXIF GPS), lightbox plein écran, slideshow, partage par lien (sous-dossier), recherche par nom, lazy loading agressif, PWA installable.

Cas d'usage : archives photos existantes (vous avez déjà tout bien rangé), partage temporaire (dossier d'événement à montrer), portfolios photographes (dossier = série).

🚀 Installation

Via Docker (recommandé)

# docker-compose.yml
services:
  foldergram:
    image: ghcr.io/foldergram/foldergram:latest
    container_name: foldergram
    restart: unless-stopped
    environment:
      - FOLDERGRAM_ROOT=/photos
    volumes:
      - /mnt/photos:/photos:ro
      - foldergram-cache:/app/cache
    ports:
      - 8088:8080

Installation manuelle

git clone https://github.com/foldergram/foldergram.git
cd foldergram
npm install
PHOTOS=/chemin/vers/photos npm start

⚙️ Configuration

  • Dossier source : variable d'environnement FOLDERGRAM_ROOT, montage :ro recommandé.
  • Cache : volume séparé pour les thumbnails (s'efface sans perte).
  • Auth : optionnelle (basic auth), utile pour exposition restreinte.
  • Performance : sur grosse collection, prévoir SSD (lecture intensive).

🔗 Alternatives

🔒 Sécurité

  • Lecture seule : :ro pour éviter qu'un bug ne supprime vos originaux.
  • Pas d'auth par défaut : activer basic auth en reverse proxy si nécessaire.
  • HTTPS : recommandé.
  • Pas de base de données : pas de risque d'injection SQL, surface d'attaque réduite.

📚 Ressources

🔗 Pages Liées