How to Install Lychee Photo Library on ECS

By Arslan Ud Din Shafiq, Alibaba Cloud Tech Share Author. Tech Share is Alibaba Cloud’s incentive program to encourage the sharing of technical knowledge and best practices within the cloud community.

Lychee is an open source photo management tool that helps you to organize your photos and create albums. Lychee does not compress or reduce the quality of the picture. It allows you to import photos from various sources such as from your computer, Dropbox, servers, or from a URL. You can expand Lychee by adding plugins to support features such as synching with any directory containing photos, watermarking your photos, and uploading photos via SSH.

In this tutorial, we will be installing and setting up Lychee photo management tool on an Alibaba Cloud Elastic Compute Service (ECS) with Ubuntu 16.04 installed.


  • You must have Alibaba Cloud Elastic Compute Service (ECS) activated and verified your valid payment method. If you are a new user, you can get $300 — $1200 worth in Alibaba Cloud credits for your new account. If you don’t know about how to setup your ECS instance, you can refer to this tutorial or quick-start guide. Your ECS instance must have at least 1GB RAM and 1 Core processor.
  • A domain name registered from Alibaba Cloud. If you have already registered a domain from Alibaba Cloud or any other host, you can update its domain nameserver records.
  • Domain name must be pointed to your Alibaba Cloud ECS’s IP address
  • Access to VNC console in your Alibaba Cloud or SSH client installed in your PC
  • Set up your server’s hostname and create user with root privileges.

Setting Up Your Server

Before proceeding with installation of any kind of package, use the following command to update your Ubuntu system. To execute this command, remember to login from non-root user with sudo privileges.

You will need to install unzip which will be used to unzip the compressed zip folder.

Install PHP

Lychee requires installation of PHP 5.5 or newer version of PHP. In this tutorial, you will install PHP 7.2. To install PHP 7.2, execute the following steps.

In the first step, you will need to install python software properties and software properties common.

You will need to add repository for newer versions of PHP.

Update the system to refresh the available repositories.

Install PHP 7.2. To install PHP 7.2, execute the following command.

Lychee requires the following PHP extensions:

  1. php7.2-imagick
  2. php7.2-common
  3. php7.2-mbstring
  4. php7.2-gd
  5. php7.2-xml
  6. php7.2-mysql
  7. php7.2-curl
  8. php7.2-zip
  9. php7.2-tidy
  10. libapache2-mod-php

To install the above extensions of PHP, execute the following command.

When you have installed all of the above extensions, apache2 will be installed automatically. You don’t need to install apache explicitly.

Imagick will help in faster processing and uploading of the images. It will also help to generate intermediate size images for small screens and thumbnails.

To check PHP installation, you can execute the following command to check installed PHP version.

Install MariaDB

Lychee supports MySQL. In this tutorial, we will use a MariaDB database. By default, Ubuntu repository has an older version of MariaDB server. To use the new version of MariaDB, you will need to add MariaDB repository to your Ubuntu system. To do so, follow the steps below.

Verify the keys by executing the following command.

Add the repository using the following command.

Update your system.

Install MariaDB using the following command.

Start and enable the MariaDB server so that after reboot, MariaDB can start automatically.

Run the following command to enhance security of MariaDB server and set password for the root user.

Now connect to the MySQL shell as root user using the command below and enter your password.

Execute the following MySQL queries in your MariaDB server.

Install Lychee

To install Lychee, you will need to follow the steps.

Navigate to /var/www/ using the command.

Download Lychee from sourceforge using the command below.

Execute the command below to see the downloaded directory name.

Unzip the downloaded zip compressed folder by executing the command below.

Remove the zip folder using the command below.

Rename Lychee-3.1.6 to Lychee. To do so, execute the command below.

You can confirm renamed file name by executing command below.

Provide ownership of /var/www/Lychee to www-data so that apache server can access the required files.

Configure Apache Server

Let’s create a virtual host configuration file for Lychee. Execute the following command, a file will be opened in nano text editor.

Copy and paste the following code and save the file.

Execute the command below to disable default site.

You will need to enable the newly created virtual host.

You will need to enable rewrite mod by editing configuration file in apache2 directory or you can simply execute the command below.

You will need to enable SSL engine. You can do so by editing configuration file in apache2 directory or you can simply execute the command below.

Open php.ini file in nano text editor by executing the command below and make some changes given below.

Save the settings by pressing Ctrl+X, type Y and hit Enter key.

You will have to restart apache server to apply the changes and load the settings by executing command below.

Now you can access Lychee via your domain name or ECS IP address. You will see the following screen.

Configure Database

To configure database, fill the database credentials details and hit connect button.

After configuration of database, you will be asked to select username and password

After clicking Create Login, you will see the following screen.

You may import or upload photos by clicking on + button in the upper right corner as shown below.

You can update the settings as shown in the screen below by clicking setting sign on upper left corner of Lychee.

Install SSL Certificate

To install SSL certificate using Let’s Encrypt, you will use Certbot. To do so, execute the following steps.

Update the package using command.

To install software-properties-common, execute the command below.

Add the certbot repository by using command below.

Update the package to load the added certbot repository using command.

Stop apache before issuance of SSL certificate.

Install python-certbot-apache using the command below.

Execute the following command to get Let’s Encrypt SSL issued.

Select option 2 to redirect the link to https and update virtual host settings for SSL.

Restart apache server.

Now you can access your website using https protocol. https://your_domain_name.tld

Set Up Firewalls and Ports

If you have activated firewalls, you will have to define a rule in Alibaba Cloud security group for your cloud server to add exception for port 80/tcp and 443/tcp. You can enable these ports while creating ECS instance, but in case if you have forgotten to unblock these ports, you can follow the procedure in this guide:

Congratulations! You go, you have successfully installed and configured Lychee on your Alibaba Cloud Elastic Compute Service (ECS) server.


Follow me to keep abreast with the latest technology news, industry insights, and developer trends.