Lychee is a open source photo-management software written in PHP and distributed under the MIT license. It allows you to easily upload, sort and manage your photos, all while presenting those with a beautiful web interface.


For this guide you should be familiar with the basic concepts of


We’re using PHP in the stable version 7.1:

[isabell@stardust ~]$ uberspace tools version show php
Using 'PHP' version: '7.1'
[isabell@stardust ~]$

You’ll need your MySQL credentials. Get them with my_print_defaults:

[isabell@stardust ~]$ my_print_defaults client
[isabell@stardust ~]$

Also, the domain you want to use for Lychee must be set up as well:

[isabell@stardust ~]$ uberspace web domain list
[isabell@stardust ~]$


Clone the Lychee code from GitHub:

[isabell@stardust ~]$ git clone ~/html
Cloning into '/home/isabell/html'...
remote: Counting objects: 10458, done.
remote: Compressing objects: 100% (8/8), done.
remote: Total 10458 (delta 3), reused 7 (delta 2), pack-reused 10448
Receiving objects: 100% (10458/10458), 5.74 MiB | 8.85 MiB/s, done.
Resolving deltas: 100% (7144/7144), done.
[isabell@stardust html]$

Now point your browser to your Lychee URL and follow the instructions.

You will need to enter the following information:

  • your MySQL hostname, username and password: the hostname is localhost and you should know your MySQL credentials by now. If you don’t, start reading again at the top.

  • your Lychee database name: we suggest you use an additional database. For example: isabell_lychee. Enter that, you can leave the prefix field empty.

For the last step you have to enter the username/password you want to use for the Lychee user.


You can regularly check their GitHub’s Atom Feed for any new Lychee releases.

If a new version is available, cd to your Lychee folder and do a simple git pull origin master:

[isabell@stardust ~]$ cd ~/html/
[isabell@stardust html]$ git pull origin master
Already up to date.
[isabell@stardust html]$

Tested with Lychee 3.1.6, Uberspace 7.1.1

Written by: TheForcer <>