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

# 📸 Lychee

> **Le gestionnaire de photos élégant et minimaliste** — un des plus anciens projets self-hosted de galerie photo. Pas d'IA, pas de reconnaissance faciale, juste une **jolie galerie web** simple et efficace.

## 📋 Informations Générales

| Attribut | Valeur |
|----------|--------|
| **Nom** | Lychee |
| **Slug** | app-lychee |
| **Description** | Gestionnaire de photos élégant, galerie web self-hosted |
| **Site officiel** | [lycheeorg.com](https://lycheeorg.com) |
| **Repository** | [LycheeOrg/Lychee](https://github.com/LycheeOrg/Lychee) |
| **Stars** | 4 183 ⭐ |
| **Licence** | MIT |
| **Langage principal** | PHP (Laravel) |
| **Catégorie** | Photos |
| **Tags** | [catalogue, photos, lychee, gallery, elegant, self-hosted, php, web] |

## 📝 Description

**Lychee** est un projet mature (lancé en 2012) qui a fait ses preuves comme **galerie photo self-hosted simple**. La philosophie : **stocker, organiser, partager** des photos via une interface web élégante. Pas de reconnaissance faciale, pas d'IA — Lychee assume de faire **un seul truc, et bien**.

Fonctionnalités : **upload drag-and-drop**, **albums** hiérarchiques, **partage public** avec lien (optionnellement protégé par mot de passe), **EXIF** complet, **téléchargement** d'originaux, **multi-utilisateurs** avec permissions, **API** REST pour intégrations, **redimensionnement** automatique pour thumbnails, **carte géographique** (EXIF GPS), **import direct depuis services cloud** (Dropbox, etc.).

**Lychee v4** (version actuelle) a été réécrite en Laravel — plus moderne, plus rapide, mais quelques utilisateurs regrettaient l'UI de v3 (le fork communautaire *Lychee v3* reste maintenu pour les fans).

## 🚀 Installation

### Via Docker (recommandé)

```yaml
# docker-compose.yml
version: "3.8"
services:
  lychee:
    image: lycheeorg/lychee:latest
    container_name: lychee
    restart: unless-stopped
    environment:
      APP_URL: http://localhost:8000
      DB_CONNECTION: mysql
      DB_HOST: db
      DB_PORT: 3306
      DB_DATABASE: lychee
      DB_USERNAME: lychee
      DB_PASSWORD: ${DB_PASSWORD}
    volumes:
      - ./uploads:/app/uploads
    ports:
      - 8000:8000
    depends_on: [db]

  db:
    image: mariadb:11
    restart: unless-stopped
    environment:
      MARIADB_DATABASE: lychee
      MARIADB_USER: lychee
      MARIADB_PASSWORD: ${DB_PASSWORD}
      MARIADB_RANDOM_ROOT_PASSWORD: "yes"
    volumes:
      - db:/var/lib/mysql

volumes:
  db:
```

> L'image officielle utilise **`lycheeorg/lychee`** (nouvelle version Laravel). Pour Lychee v3 (PHP classique), utiliser `lycheeorg/lychee-v3`.

### Installation manuelle

```bash
# PHP 8.1+ avec extensions : gd, exif, mbstring, pdo_mysql
git clone https://github.com/LycheeOrg/Lychee.git
cd Lychee && composer install
cp .env.example .env && php artisan key:generate
php artisan migrate
php artisan serve
```

## ⚙️ Configuration

- **PHP-FPM** + Nginx (recommandé en prod) ou Apache.
- **Stockage** : volume `/app/uploads` (originaux + thumbnails redimensionnés).
- **Reverse proxy** HTTPS devant (Caddy/Traefik).
- **Permissions** : storage et bootstrap/cache en écriture pour PHP.

## 🔗 Alternatives

- **[[app-photoprism]]** — Avec IA et reconnaissance faciale
- **[[app-piwigo]]** — Concurrent PHP plus ancien, plus orienté "galerie publique"
- **[[app-photoview]]** — Plus moderne, sans PHP

## 🔒 Sécurité

- **Authentification** : login local (sessions Laravel), OAuth/LDAP supportés.
- **Liens publics** : par défaut non-listés, peuvent être protégés par mot de passe.
- **HTTPS** obligatoire (Caddy/Traefik) pour partage public et applis tierces.

## 📚 Ressources

- [Site officiel Lychee](https://lycheeorg.com)
- [Repository GitHub](https://github.com/LycheeOrg/Lychee)
- [Documentation utilisateur](https://lycheeorg.com/docs/)

## 🔗 Pages Liées

- [[cat-photos]] (n'existe pas encore, OK)
- [[app-piwigo]]
- [[app-photoview]]
- [[app-traefik]]
- [[recettes-docker-compose]]
- [[securisation-home-lab]]