Installation

1. Basic Requirements

Everything you need is a web-server with PHP 5.5 or later, composer and a MySQL-Database.

The following PHP extensions must be activated:

session, exif, mbstring, gd, mysqli, json, zip, imagick

To use Lychee without restrictions, we recommend to increase the values of the following properties in php.ini:

max_execution_time = 200
post_max_size = 100M
upload_max_filesize = 20M
memory_limit = 256M

You might also take a look at the FAQ.

1.1 Video Thumbnails

Since release 3.2.0, Lychee allows the upload of videos. In order to have thumbnails for the uploaded videos, you will need to do the following:

1. Install ffmpeg on your server system
2. Install PHP dependencies (php-ffmpeg is needed)
3. Adjust the upload_max_filesize limit in your php.ini according to your needs, e.g. upload_max_filesize=150m

Note: As soon as php-ffmpeg is available, Lychee tries to create thumbnails for uploaded videos. If php-ffmpegis available but not ffmpeg, Lychee will fail to upload a video into the gallery.

2. Download and install dependencies

The easiest way to download Lychee is with git and install php libraries with composer:

git clone --recurse-submodules https://github.com/LycheeOrg/Lychee.git

This will also download this Wiki and the source of Lychee frontend.

3. Install PHP dependencies

First install composer if not already available then do:

cd Lychee
composer update

4. Permissions

Change the permissions of uploads/, data/ and all their subfolders. Sufficient read/write privileges are required.

chmod -R 775 uploads/ data/

5. Finish

Open Lychee in your browser and follow the given steps.

If you have trouble, take a look at the FAQ.