Lychee is an open-source web-based photo management and sharing application that allows you to store and organize your photos on your own server. In this tutorial, we will walk you through the process of installing Lychee on MXLinux Latest with Apache and PHP.
Before we start the installation process, make sure your system meets the following requirements:
The first step is to install the required packages that are necessary for Lychee to run on your system. Run the following command to install the required packages:
sudo apt-get update
sudo apt-get install git php-cli php-gd php-curl php-mbstring php-xml php-mysql
Now that you have installed the required packages, you can clone the Lychee repository to your server. Run the following command to clone the repository:
cd /var/www/html
sudo git clone https://github.com/LycheeOrg/Lychee.git
Next, you need to configure Apache to serve Lychee. Run the following command to create a new Apache virtual host configuration file for Lychee:
sudo nano /etc/apache2/sites-available/lychee.conf
Add the following content to the configuration file:
<VirtualHost *:80>
ServerName example.com
DocumentRoot /var/www/html/Lychee/
<Directory /var/www/html/Lychee/>
Options -Indexes +FollowSymLinks
AllowOverride All
Require all granted
</Directory>
ErrorLog ${APACHE_LOG_DIR}/lychee_error.log
CustomLog ${APACHE_LOG_DIR}/lychee_access.log combined
</VirtualHost>
Replace example.com with your domain name or IP address. Save and close the file.
Next, enable the virtual host by running the following command:
sudo a2ensite lychee
Finally, reload the Apache service for the changes to take effect:
sudo systemctl reload apache2
Lychee requires a database to store the metadata and settings of your photos. You can use one of the following databases:
In this tutorial, we will use MySQL as our database. If you don't have MySQL installed, you can install it by running the following command:
sudo apt-get install mysql-server
Once you have MySQL installed, log in to the MySQL shell by running the following command:
sudo mysql -u root -p
Create a new MySQL database and user for Lychee by running the following commands:
CREATE DATABASE lychee;
CREATE USER 'lycheeuser'@'localhost' IDENTIFIED BY 'lycheepassword';
GRANT ALL PRIVILEGES ON lychee.* TO 'lycheeuser'@'localhost';
FLUSH PRIVILEGES;
Replace lycheeuser and lycheepassword with your own database username and password.
Now that the Lychee repository is cloned and Apache and MySQL are configured, you can configure Lychee to use the MySQL database.
Run the following command to copy the default configuration file:
cp /var/www/html/Lychee/data/config.php.dist /var/www/html/Lychee/data/config.php
Open the Lychee configuration file by running the following command:
sudo nano /var/www/html/Lychee/data/config.php
Update the following lines in the file with your MySQL database connection details:
$dbHost = 'localhost';
$dbUser = 'lycheeuser';
$dbPassword = 'lycheepassword';
$dbName = 'lychee';
Save and close the file.
Next, ensure that the uploads, uploads/thumb, and uploads/big directories are writable by the Apache user. Run the following commands to set the appropriate permissions:
sudo chown -R www-data:www-data /var/www/html/Lychee/uploads
sudo chmod -R 777 /var/www/html/Lychee/uploads
You have now successfully installed and configured Lychee on your MXLinux Latest server. You can access the Lychee web interface by opening a web browser and navigating to your server's IP address or domain name, followed by /Lychee. For example:
http://example.com/Lychee
You should see the Lychee login page. Use the default username Administrator and password password to log in.
After logging in, you can start adding photos and organizing them into albums.
Lychee is a powerful open-source photo management and sharing application that allows you to store and organize your photos on your own server. By following this tutorial, you should now have Lychee up and running on your MXLinux Latest server. Happy photo sharing!
If you want to self-host in an easy, hands free way, need an external IP address, or simply want your data in your own hands, give IPv6.rs a try!
