---
title: Foldergram
created: 2026-06-07
updated: 2026-06-07
type: app
tags: [catalogue, photos, gallery, folder, simple, self-hosted, web]
confidence: high
contested: false
sources: [https://selfh.st/apps/?tag=Photos, https://github.com/foldergram/foldergram]
---

# 📸 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](https://foldergram.app) |
| **Repository** | [foldergram/foldergram](https://github.com/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é)

```yaml
# 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

```bash
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

- **[[app-pigallery2]]** — Même philosophie, mais en Go (plus performant)
- **[[app-foldergram]]** — (vous y êtes déjà)
- **[[app-photoview]]** — Galerie Go avec plus de fonctionnalités sociales

## 🔒 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

- [Site officiel](https://foldergram.app)
- [Repository GitHub](https://github.com/foldergram/foldergram)
- [Démo en ligne](https://foldergram.app/demo)

## 🔗 Pages Liées
- [[cat-photos]]
- [[app-pigallery2]]
- [[app-photoview]]
- [[app-traefik]]
- [[recettes-docker-compose]]
- [[securisation-home-lab]]