Comment installer le système de gestion de photos Lychee sur Debian 12

Lychee est un logiciel de gestion de photos open-source basé sur PHP et MySQL. C’est un système de gestion de photos auto-hébergé qui vous permet de télécharger, parcourir et partager des photos en toute sécurité sur votre serveur.

Dans ce tutoriel, vous apprendrez à installer Lychee Photo Management sur un serveur Debian 12. Vous utiliserez la pile LAMP pour exécuter Lychee et sécuriser Lychee avec HTTPS via Certbot et Letsencrypt.

Prérequis

Avant de commencer, assurez-vous d’avoir les éléments suivants :

• Un serveur Debian 12
• Un utilisateur non-root avec des privilèges d’administrateur

Installation des dépendances

Dans cette section, vous allez installer la pile LAMP (Linux, Apache, MariaDB et PHP) sur le serveur Debian. Pour l’instant, Lychee prend en charge PHP 8.2 ou supérieur, qui est disponible par défaut dans le dépôt Debian.

Tout d’abord, exécutez la commande ci-dessous pour mettre à jour votre index de paquets Ubuntu.

sudo apt update

Maintenant, installez les paquets de la pile LAMP sur votre système Debian avec la commande suivante. Entrez ‘ Y ‘ pour confirmer l’installation.

sudo apt install apache2 mariadb-server php-cli php-intl php-xmlrpc php-soap php-mysql php-zip php-gd php-tidy php-mbstring php-curl php-xml php-pear php-bcmath php-imagick php-tokenizer libapache2-mod-php

Après l’installation, exécutez la commande ci-dessous pour vérifier l’état du service Apache. Vous verrez que le serveur web Apache est en cours d’exécution et activé.

sudo systemctl is-enabled apache2  
sudo systemctl status apache2

Maintenant, vérifiez le serveur MariaDB avec la commande suivante. Le serveur MariaDB devrait être en cours d’exécution et activé automatiquement sur votre système.

sudo systemctl is-enabled mariadb  
sudo systemctl status mariadb

Enfin, vérifiez la version de PHP avec la commande suivante - Vous pouvez voir que PHP 8.3 est installé.

php -v  
php -m

Configuration de PHP

Après l’installation des dépendances, vous allez configurer PHP en modifiant le fichier ‘php.ini’ et en redémarrant le serveur web Apache pour que les modifications prennent effet.

Ouvrez le fichier ‘ /etc/php/8.3/apache2/php.ini ‘ avec l’éditeur ‘ nano ‘.

sudo nano /etc/php/8.3/apache2/php.ini

Changez la configuration par défaut comme suit - Assurez-vous d’ajuster les options ‘ memory_limit ‘ et ‘ date.timezone ‘ en conséquence.

date.timezone = Europe/Amsterdam  
memory_limit = 256M  
  
upload_max_filesize = 64MB  
post_max_size = 64MB

Lorsque vous avez terminé, enregistrez le fichier et quittez l’éditeur.

Maintenant, exécutez la commande ‘ systemctl ‘ ci-dessous pour redémarrer le serveur web Apache et appliquer vos modifications.

sudo systemctl restart apache2

Configuration du serveur MariaDB

Avec PHP configuré, vous allez sécuriser le serveur MariaDB en utilisant la commande ‘ mariadb-secure-installation ‘. Ensuite, vous créerez une nouvelle base de données et un utilisateur qui seront utilisés pour Lychee via le client ‘ mariadb ‘.

Exécutez la commande ‘ mariadb-secure-installation ‘ ci-dessous pour configurer votre serveur MariaDB.

sudo mariadb-secure-installation

Vous serez maintenant invité à configurer MariaDB comme suit :

• Pour l’installation par défaut du serveur MariaDB sans mot de passe root, appuyez sur ENTRER lorsqu’on vous demande le mot de passe.
• L’authentification locale pour les utilisateurs root de MariaDB est sécurisée par défaut, entrez ‘n’ lorsqu’on vous demande de changer la méthode d’authentification en ‘unix_socket’.
• Entrez ‘Y’ pour créer un nouveau mot de passe root MariaDB. Ensuite, entrez le mot de passe fort pour votre utilisateur root MariaDB et répétez.
• Lorsqu’on vous demande de désactiver l’authentification à distance pour l’utilisateur root de MariaDB, entrez ‘Y’ pour accepter.
• L’installation par défaut du serveur MariaDB est livrée avec la base de données ‘test’ et permet à un utilisateur anonyme d’y accéder.
• Entrez ‘Y’ pour les deux paramètres afin de supprimer la base de données par défaut ‘test’ et de supprimer le privilège anonyme.
• Enfin, entrez ‘Y’ pour confirmer le rechargement des privilèges de table.

Après que MariaDB soit configuré et sécurisé, vous allez créer une nouvelle base de données et un utilisateur qui seront utilisés par l’installation de Lychee.

Connectez-vous au serveur MariaDB avec la commande ‘ mariadb ‘ ci-dessous. Entrez votre mot de passe root MariaDB lorsqu’on vous le demande.

sudo mariadb -u root -p

Maintenant, exécutez les requêtes suivantes pour créer une nouvelle base de données ‘ lychee ‘ avec l’utilisateur ‘ lycheeuser@localhost ‘ et le mot de passe ‘ LycheePassword ‘. Vous pouvez changer les détails de la base de données selon vos besoins.

CREATE DATABASE lychee;  
GRANT ALL PRIVILEGES ON lychee. * TO lycheeuser@'localhost' IDENTIFIED BY 'LycheePassword' WITH GRANT OPTION;  
FLUSH PRIVILEGES;

Ensuite, exécutez la requête ci-dessous pour vous assurer que l’utilisateur ‘ lycheeuser@localhost ‘ peut accéder à la base de données ‘ lychee ‘.

SHOW GRANTS FOR lycheeuser@localhost;

Si tout se passe bien, vous verrez la sortie suivante :

Enfin, tapez ‘ quit ‘ pour quitter le serveur MariaDB.

Téléchargement de Lychee Photo Management

Maintenant que vous avez configuré à la fois PHP et MariaDB, vous allez télécharger le code source de Lychee et configurer le répertoire d’installation et le fichier ‘.env’.

Mais d’abord, installez le paquet ‘unzip’ sur votre système Debian avec la commande suivante.

sudo apt install unzip -y

Allez dans le répertoire ‘ /var/www ‘ et téléchargez la version du code source de Lychee en utilisant la commande ‘ wget ‘ ci-dessous. Assurez-vous de récupérer le lien pour la dernière version depuis la page de version de Lychee.

cd /var/www/  
wget https://github.com/LycheeOrg/Lychee/releases/download/v5.5.1/Lychee.zip

Une fois téléchargé, extrayez le code source de Lychee avec la commande ‘ unzip ‘ ci-dessous. Le code source sera extrait dans le répertoire ‘ /var/www/Lychee ‘.

unzip Lychee.zip

Ensuite, exécutez la commande suivante pour changer la propriété du répertoire ‘ /var/www/Lychee ‘ à l’utilisateur ‘ www-data ‘, et rendre certains répertoires accessibles en écriture pour l’utilisateur ‘ www-data ‘.

sudo chown -R www-data:www-data /var/www/Lychee  
sudo chmod u+rw /var/www/Lychee/{storage,bootstrap/cache/,public/dist,public/uploads,public/sym}

Maintenant, exécutez la commande suivante pour copier le fichier ‘ .env ‘ pour Lychee et le modifier en utilisant l’éditeur ‘ nano ‘.

sudo -u www-data cp /var/www/Lychee/.env-example /var/www/Lychee/.env  
sudo -u www-data nano /var/www/Lychee/.env

Changez le APP_URL par défaut avec votre nom de domaine et la configuration de la base de données avec le ‘ mysql ‘ et vos détails de base de données comme suit :

# nom de domaine  
APP_URL=https://photo.howtoforge.local  
  
# base de données pour MariaDB/MySQL  
DB_CONNECTION=mysql  
DB_HOST=localhost  
DB_PORT=3306  
DB_DATABASE=lychee  
DB_USERNAME=lycheeuser  
DB_PASSWORD=LycheePassword

Enregistrez le fichier et quittez l’éditeur.

Création d’un hôte virtuel Apache

Dans cette section, vous allez créer un nouveau fichier d’hôte virtuel Apache pour exécuter Lychee Photo Management.

Tout d’abord, exécutez la commande ci-dessous pour activer le module ‘rewrite’.

sudo a2enmod rewrite

Maintenant, éditez la configuration Apache ‘ /etc/apache2/apache.conf ‘ en utilisant ‘ nano ‘.

sudo nano /etc/apache2/apache.conf

Ajoutez la configuration suivante au fichier. Cela vous permet de configurer le ‘ .htaccess ‘ pour les règles de réécriture.

  
 Options Indexes FollowSymLinks  
 AllowOverride All  
 Require all granted  

Enregistrez le fichier et quittez l’éditeur.

Maintenant, créez une nouvelle configuration d’hôte virtuel Apache ‘ /etc/apache2/sites-available/lychee.conf ‘ avec la commande de l’éditeur ‘ nano ‘ ci-dessous.

sudo nano /etc/apache2/sites-available/lychee.conf

Collez la configuration suivante et assurez-vous de changer l’option ‘ ServerName ‘ avec votre nom de domaine cible. Assurez-vous qu’il soit identique à l’APP_URL dans le fichier ‘ .env ‘.

  
  
  ServerAdmin [email protected]  
  ServerName photo.howtoforge.local  
  
  DocumentRoot /var/www/Lychee/  
  
  ErrorLog /var/log/apache2/photo-howtoforge-local-error_log  
  CustomLog /var/log/apache2/photo-howtoforge-local-access_log common  
  

Lorsque vous avez terminé, enregistrez et quittez le fichier.

Maintenant, exécutez la commande ci-dessous pour activer le fichier d’hôte virtuel ‘ lychee.conf ‘ et vérifier votre syntaxe Apache. Si vous avez une syntaxe Apache correcte, vous verrez une sortie ‘ Syntax is OK ‘.

sudo a2ensite lychee.conf  
sudo apachectl configtest

Enfin, exécutez la commande suivante pour redémarrer Apache et appliquer vos modifications.

sudo systemctl restart apache2

Sécurisation de Lychee avec HTTPS

Si vous exécutez Lychee sur un nom de domaine public, assurez-vous de le sécuriser avec HTTPS. Dans cette section, vous allez installer Certbot et sécuriser Lychee avec des certificats SSL/TLS de Letsencrypt.

Exécutez la commande ci-dessous pour installer Certbot et le plugin Apache.

sudo apt install certbot python3-certbot-apache -y

Après l’installation, exécutez la commande ‘ certbot ‘ suivante pour générer de nouveaux certificats SSL/TLS pour l’installation de Lychee. Assurez-vous de changer le nom de domaine et l’adresse e-mail dans cette commande.

sudo certbot --apache --agree-tos --redirect --hsts --staple-ocsp --email [email protected] -d photo.howtoforge.local

Lorsque le processus est terminé, votre installation de Lychee devrait être sécurisée avec HTTPS et vos certificats SSL/TLS seront disponibles dans le répertoire ‘/etc/letsencrypt/live/domain.com’.

Installation de Lychee Photo Management

Visitez le nom de domaine d’installation de Lychee tel que https://photo.howtoforge.local/ en utilisant votre navigateur web préféré et vous verrez l’assistant d’installation de Lychee.

Cliquez sur Suivant pour procéder à l’installation.

Assurez-vous que chaque extension PHP est installée et que le module ‘rewrite’ d’Apache est activé sur votre système.

Assurez-vous que PHP peut lire, écrire et exécuter dans certains de ces répertoires.

Vérifiez le fichier ‘.env’ sur votre écran et assurez-vous que votre nom de domaine et les détails de MariaDB sont corrects.

Maintenant, l’installateur va générer la clé d’application pour Lychee.

Entrez votre utilisateur admin, adresse e-mail et mot de passe. L’installation de Lychee devrait être terminée.

Sur la page d’accueil de Lychee, cliquez sur l’invite de connexion, puis entrez votre utilisateur admin et votre mot de passe.

Vous pouvez voir ci-dessous le tableau de bord utilisateur de Lychee après avoir téléchargé quelques images sur le serveur Lychee.

Conclusion

Félicitations ! Vous avez terminé l’installation de Lychee Photo Management sur le serveur Debian 12 avec la pile LAMP (Linux, Apache, MariaDB et PHP). Vous avez également sécurisé Lychee avec HTTPS via Certbot et Letsencrypt.