# Install Lychee - Photo Management System - On Windows

## What is Lychee?

> Lychee is a free photo-management tool, which runs on your server or web-space. Installing is a matter of seconds. Upload, manage and share photos like from a native application. Lychee comes with everything you need and all your photos are stored securely. -https://lycheeorg.github.io/

## Installation

1. Download XAMPP Download
2. Download Lychee Download
3. Download Microsoft Visual C++ Download
4. Install Microsoft Visual C++
5. Right click the downloaded XAMPP file > Extract All...
6. Right click the downloaded Lychee.zip file > Extract All...
7. Rename the Extracted folder lychee (all lowercase)
8. Cut the lychee folder inside the XAMPP directory
9. Navigate back to the Downloads directory and copy the extracted XAMPP directory to a safe location to run from, C:\Program Files for example
10. Run XAMPP/setup_xampp.bat to update the configuration files with the new server location
11. Navigate into XAMPP/PHP and edit php.ini in a text editor
12. Find the list of extensions and make sure the following are enabled by removing the ; at the start of the line

    extension=curl
    extension=fileinfo
    extension=gd
    extension=xsl
    extension=mbstring
    extension=mysqli
    extension=pdo_mysql

13. Save the changes to php.ini
14. Navigate into XAMPP/Apache/conf and edit httpd.conf in a text editor
15. Paste the following at the bottom of the httpd.conf file

    Alias /lychee "C:/Program Files/xampp/lychee/public"
    <Directory "C:/Program Files/xampp/lychee/public">
    # enable the .htaccess rewrites
    AllowOverride All
    Options +FollowSymLinks
    Require all granted
    Order allow,deny
    Allow from All
    </Directory>

16. Save the changes and close out of the editor
17. Back in File Explorer, run XAMPP/xampp-control.exe
18. Click the Start buttons next to Apache and MySQL
19. Navigate to XAMPP/mysql/bin
20. Hold the SHIFT key and right click in the white space > Open PowerShell window here...
21. Run the following commands in the PowerShell window to setup the database
    .\mysql -u root
    CREATE DATABASE lychee;
    GRANT ALL ON lychee.* to 'lychee_rw'@'localhost' IDENTIFIED BY 'Lych33!';
    FLUSH PRIVILEGES;
    EXIT;
    exit

## Lychee Web Installer

1. Open a web browser and navigate to http://DNSorIP/lychee
2. Click Next at the Lychee welcome screen
3. Click Next at the Requirements Check
4. Click Next at the Permissions Check
5. Update at least the following values in the

   APP_URL=http://DNSorIP
   APP_DIR=/lychee
   DB_CONNECTION=mysql
   DB_HOST=localhost
   DB_PORT=3306
   DB_DATABASE=lychee
   DB_USERNAME=lychee_rw
   DB_PASSWORD=Lych33!

6. Click Save > Click Install
7. Once the installation completes click Set up admin account
8. Enter a Username > Enter and confirm a Password > Click Create admin account
9. Click Open Lychee

Documentation: https://lycheeorg.github.io/docs/#installation