wiki/Catalogue-Self-Hosted/apps/app-lychee.md

---

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
Repository	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é)

# 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

# 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
• Repository GitHub
• Documentation utilisateur

🔗 Pages Liées

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