Cómo instalar el sistema de gestión de fotos Lychee en Debian 12

Lychee es un software de gestión de fotos de código abierto basado en PHP y MySQL. Es un sistema de gestión de fotos autohospedado que te permite subir, navegar y compartir fotos de manera segura en tu servidor.

En este tutorial, aprenderás a instalar Lychee Photo Management en un servidor Debian 12. Estarás utilizando el LAMP Stack para ejecutar Lychee y asegurar Lychee con HTTPS a través de Certbot y Letsencrypt.

Prerrequisitos

Antes de comenzar, asegúrate de tener lo siguiente:

• Un servidor Debian 12
• Un usuario no root con privilegios de administrador

Instalando dependencias

En esta sección, instalarás el LAMP Stack (Linux, Apache, MariaDB y PHP) en el servidor Debian. Por ahora, Lychee es compatible con PHP 8.2 o superior, que está disponible por defecto en el repositorio de Debian.

Primero, ejecuta el siguiente comando para actualizar tu índice de paquetes de Ubuntu.

sudo apt update

Ahora instala los paquetes del LAMP Stack en tu sistema Debian con el siguiente comando. Ingresa ‘ Y ‘ para confirmar la instalación.

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

Después de que la instalación esté completa, ejecuta el siguiente comando para verificar el estado del servicio Apache. Verás que el servidor web Apache está en funcionamiento y habilitado.

sudo systemctl is-enabled apache2  
sudo systemctl status apache2

Ahora verifica el servidor MariaDB con el siguiente comando. El servidor MariaDB debería estar en funcionamiento y habilitado automáticamente en tu sistema.

sudo systemctl is-enabled mariadb  
sudo systemctl status mariadb

Por último, verifica la versión de PHP con el siguiente comando - Puedes ver que PHP 8.3 está instalado.

php -v  
php -m

Configurando PHP

Después de instalar las dependencias, configurarás PHP editando el archivo ‘php.ini’ y reiniciando el servidor web Apache para que los cambios surtan efecto.

Abre el archivo ‘ /etc/php/8.3/apache2/php.ini ‘ con el editor ‘ nano ‘.

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

Cambia la configuración predeterminada así - Asegúrate de ajustar las opciones ‘ memory_limit ‘ y ‘ date.timezone ‘ en consecuencia.

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

Cuando termines, guarda el archivo y sal del editor.

Ahora ejecuta el comando ‘ systemctl ‘ a continuación para reiniciar el servidor web Apache y aplicar tus cambios.

sudo systemctl restart apache2

Configurando el servidor MariaDB

Con PHP configurado, asegurarás el servidor MariaDB utilizando el comando ‘ mariadb-secure-installation ‘. Y luego, crearás una nueva base de datos y un usuario que se utilizarán para Lychee a través del cliente ‘ mariadb ‘.

Ejecuta el comando ‘ mariadb-secure-installation ‘ a continuación para configurar tu servidor MariaDB.

sudo mariadb-secure-installation

Ahora se te preguntará sobre las siguientes configuraciones de MariaDB:

• Para la instalación predeterminada del servidor MariaDB sin una contraseña de root, presiona ENTER cuando se te pregunte sobre la contraseña.
• La autenticación local para los usuarios root de MariaDB está asegurada por defecto, ingresa ‘n’ cuando se te pregunte si deseas cambiar el método de autenticación a ‘unix_socket’.
• Ingresa ‘Y’ para crear una nueva contraseña de root de MariaDB. Luego, ingresa la contraseña fuerte para tu usuario root de MariaDB y repítela.
• Cuando se te pregunte si deseas deshabilitar la autenticación remota para el usuario root de MariaDB, ingresa ‘Y’ para aceptar.
• La instalación predeterminada del servidor MariaDB viene con la base de datos ‘test’ y permite que un usuario anónimo acceda a ella.
• Ingresa ‘Y’ para ambas configuraciones para eliminar la base de datos predeterminada ‘test’ y eliminar el privilegio anónimo.
• Por último, ingresa ‘Y’ para confirmar la recarga de los privilegios de tabla.

Después de que MariaDB esté configurado y asegurado, crearás una nueva base de datos y un usuario que se utilizarán en la instalación de Lychee.

Inicia sesión en el servidor MariaDB con el comando ‘ mariadb ‘ a continuación. Ingresa tu contraseña de root de MariaDB cuando se te pida.

sudo mariadb -u root -p

Ahora ejecuta las siguientes consultas para crear una nueva base de datos ‘ lychee ‘ con el usuario ‘ lycheeuser@localhost ‘ y la contraseña ‘ LycheePassword ‘. Puedes cambiar los detalles de la base de datos según sea necesario.

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

A continuación, ejecuta la consulta a continuación para asegurarte de que el usuario ‘ lycheeuser@localhost ‘ pueda acceder a la base de datos ‘ lychee ‘.

SHOW GRANTS FOR lycheeuser@localhost;

Si todo va bien, verás la siguiente salida:

Por último, escribe ‘ quit ‘ para salir del servidor MariaDB.

Descargando Lychee Photo Management

Ahora que has configurado tanto PHP como MariaDB, descargarás el código fuente de Lychee y configurarás el directorio de instalación y el archivo ‘.env’.

Pero primero, instala el paquete ‘unzip’ en tu sistema Debian con el siguiente comando.

sudo apt install unzip -y

Ve al directorio ‘ /var/www ‘ y descarga la versión del código fuente de Lychee utilizando el comando ‘ wget ‘ a continuación. Asegúrate de obtener el enlace para la última versión de la página de lanzamientos de Lychee.

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

Una vez descargado, extrae el código fuente de Lychee con el comando ‘ unzip ‘ a continuación. El código fuente se extraerá en el directorio ‘ /var/www/Lychee ‘.

unzip Lychee.zip

A continuación, ejecuta el siguiente comando para cambiar la propiedad del directorio ‘ /var/www/Lychee ‘ al usuario ‘ www-data ‘, y hacer que algunos directorios sean escribibles para el usuario ‘ 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}

Ahora ejecuta el siguiente comando para copiar el archivo ‘ .env ‘ para Lychee y modificarlo utilizando el editor ‘ nano ‘.

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

Cambia el APP_URL predeterminado con tu nombre de dominio y la configuración de la base de datos con el ‘ mysql ‘ y los detalles de tu base de datos como sigue:

# nombre de dominio  
APP_URL=https://photo.howtoforge.local  
  
# base de datos para MariaDB/MySQL  
DB_CONNECTION=mysql  
DB_HOST=localhost  
DB_PORT=3306  
DB_DATABASE=lychee  
DB_USERNAME=lycheeuser  
DB_PASSWORD=LycheePassword

Guarda el archivo y sal del editor.

Creando un host virtual de Apache

En esta sección, crearás un nuevo archivo de host virtual de Apache para ejecutar Lychee Photo Management.

Primero, ejecuta el siguiente comando para activar el módulo ‘rewrite’.

sudo a2enmod rewrite

Ahora edita la configuración de Apache ‘ /etc/apache2/apache.conf ‘ utilizando ‘ nano ‘.

sudo nano /etc/apache2/apache.conf

Agrega la siguiente configuración al archivo. Esto te permite configurar el ‘ .htaccess ‘ para las reglas de reescritura.

  
 Options Indexes FollowSymLinks  
 AllowOverride All  
 Require all granted  

Guarda el archivo y sal del editor.

Ahora crea una nueva configuración de host virtual de Apache ‘ /etc/apache2/sites-available/lychee.conf ‘ con el comando del editor ‘ nano ‘ a continuación.

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

Pega la siguiente configuración y asegúrate de cambiar la opción ‘ ServerName ‘ con tu nombre de dominio objetivo. Asegúrate de que sea el mismo que el APP_URL dentro del archivo ‘ .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  
  

Cuando termines, guarda y sal del archivo.

Ahora ejecuta el siguiente comando para activar el archivo de host virtual ‘ lychee.conf ‘ y verificar la sintaxis de Apache. Si tienes la sintaxis de Apache correcta, verás una salida ‘ Syntax is OK ‘.

sudo a2ensite lychee.conf  
sudo apachectl configtest

Por último, ejecuta el siguiente comando para reiniciar Apache y aplicar tus cambios.

sudo systemctl restart apache2

Asegurando Lychee con HTTPS

Si estás ejecutando Lychee en el nombre de dominio público, asegúrate de asegurarlo con HTTPS. En esta sección, instalarás Certbot y asegurarás Lychee con certificados SSL/TLS de Letsencrypt.

Ejecuta el siguiente comando para instalar Certbot y el complemento de Apache.

sudo apt install certbot python3-certbot-apache -y

Después de que la instalación esté completa, ejecuta el siguiente comando ‘ certbot ‘ para generar nuevos certificados SSL/TLS para la instalación de Lychee. Asegúrate de cambiar el nombre de dominio y la dirección de correo electrónico en este comando.

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

Cuando el proceso esté completo, tu instalación de Lychee debería estar asegurada con HTTPS y tus certificados SSL/TLS estarán disponibles en el directorio ‘/etc/letsencrypt/live/domain.com’.

Instalando Lychee Photo Management

Visita el nombre de dominio de instalación de Lychee como https://photo.howtoforge.local/ utilizando tu navegador web preferido y verás el asistente de instalación de Lychee.

Haz clic en Siguiente para continuar con la instalación.

Asegúrate de que cada extensión de PHP esté instalada y que el módulo ‘rewrite’ de Apache esté habilitado en tu sistema.

Asegúrate de que PHP pueda leer, escribir y ejecutar dentro de algunos de esos directorios.

Verifica el archivo ‘.env’ en tu pantalla y asegúrate de que tu nombre de dominio y los detalles de MariaDB sean correctos.

Ahora el instalador generará la clave de la aplicación para Lychee.

Ingresa tu usuario administrador, dirección de correo electrónico y contraseña. Y la instalación de Lychee debería estar completa.

En la página de inicio de Lychee, haz clic en el aviso de inicio de sesión, y luego ingresa tu usuario administrador y contraseña.

Puedes ver a continuación el panel de usuario de Lychee después de subir algunas imágenes al servidor de Lychee.

Conclusión

¡Felicidades! Has completado la instalación de Lychee Photo Management en el servidor Debian 12 con el LAMP Stack (Linux, Apache, MariaDB y PHP). También has asegurado Lychee con HTTPS a través de Certbot y Letsencrypt.