Lychee is a free, open-source photo-management tool that runs on your server or web space. Installation is quick and easy, taking just seconds. With Lychee, you can upload, manage, and share your photos seamlessly, just like using a native application. It comes with all the essential features you need, ensuring your photos are stored securely. Read more on our website.
For even more advanced features, consider the Supporter Edition (SE). The SE version offers additional functionality to enhance your experience. Learn more about the Supporter Edition and its benefits here.
Version 7.0 introduces significant changes on the docker image. Please refer to our Upgrade Guide for detailed instructions on how to upgrade from previous versions.
We aim to maintain a free open-source photography library with high quality of code.
Being in control of our own data, our own pictures is something that we value above all.
Through contributions, donations, and sponsorship, you allow Lychee to thrive. Your donations directly support demo server costs, continuous enhancements, and most importantly bug fixes!
Contributions welcome! Check out our Contribution Guide and documentation for setup, coding standards, and PR guidelines.
AI-assisted contributions are permitted — see our AI/Claude Guidelines and AGENTS.md for the Specification-Driven Development workflow.
Want to quickly test Lychee? Use the minimal docker-compose template:
curl -O https://raw.githubusercontent.com/LycheeOrg/Lychee/master/docker-compose.minimal.yaml
docker compose -f docker-compose.minimal.yaml up -dThen open http://localhost:8000 in your browser. This setup includes a separate worker container for background jobs.
The easiest way to deploy Lychee with all dependencies configured:
services:
lychee:
image: ghcr.io/lycheeorg/lychee:latestcontainer_name: lycheeports:
- "8000:8000"volumes:
- ./lychee/uploads:/app/public/uploads
- ./lychee/logs:/app/storage/logs
- ./lychee/tmp:/app/storage/tmpenvironment:
APP_URL: http://localhost:8000DB_CONNECTION: mysqlDB_HOST: lychee_dbDB_PORT: 3306DB_DATABASE: lycheeDB_USERNAME: lycheeDB_PASSWORD: lychee_password# Generate the APP_KEY with `echo "base64:$(openssl rand -base64 32)"` and set it here (without the < >)# APP_KEY: base64:<result of 'openssl rand -base64 32'>depends_on:
lychee_db:
condition: service_healthyrestart: unless-stoppedlychee_db:
image: mariadb:11container_name: lychee_dbenvironment:
MYSQL_DATABASE: lycheeMYSQL_USER: lycheeMYSQL_PASSWORD: lychee_passwordMYSQL_ROOT_PASSWORD: root_passwordvolumes:
- lychee_db:/var/lib/mysqlhealthcheck:
test: ["CMD", "healthcheck.sh", "--connect", "--innodb_initialized"]interval: 5stimeout: 3sretries: 10restart: unless-stoppedvolumes:
lychee_db:Images:GitHub Container Registry | Docker Hub
Docker Tags:
latest- Latest stable releaseedge- Latest development build from master
- Pre-built releases: Download from GitHub Releases
- From source: Requires PHP 8.4+, Composer, and npm
For detailed installation, configuration, and update instructions, see our Documentation.
- Documentation - Complete guides and FAQ
- GitHub Issues - Report bugs
- Discord - Community support
We would like to thank Jetbrains for supporting us with their Open Source Development - Community Support program.