lychee

v7.12.0-ls80

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.

Photos

docker pull lscr.io/linuxserver/lychee:latest

Quick start

Generated from the image's own configuration. Replace the /path/to folders with real paths on your host.

Include optional settings

---
services:
  lychee:
    image: lscr.io/linuxserver/lychee:latest
    container_name: lychee
    environment:
      - PUID=1000
      - PGID=1000
      - TZ=Etc/UTC
      - DB_CONNECTION=
      - DB_HOST=
      - DB_PORT=
      - DB_USERNAME=
      - DB_PASSWORD=
      - DB_DATABASE=
      - APP_NAME=Lychee # optional
      - APP_URL= # optional
      - TRUSTED_PROXIES= # optional
    volumes:
      - /path/to/lychee/config:/config
      - /path/to/pictures:/pictures
    ports:
      - 80:80
    restart: unless-stopped

Parameters

Ports
Port	Function	Required
80:80	http gui	required

Environment variables
Variable	Function	Required
PUID=1000	User ID	required
PGID=1000	Group ID	required
TZ=Etc/UTC	Timezone	required
DB_CONNECTION=	DB type, from `sqlite`, `mysql`, `pqsql`.	required
DB_HOST=	DB server hostname. For `mysql` and `pgsql` only.	required
DB_PORT=	DB server port. For `mysql` and `pgsql` only.	required
DB_USERNAME=	DB user. For `mysql` and `pgsql` only.	required
DB_PASSWORD=	DB password. For `mysql` and `pgsql` only.	required
DB_DATABASE=	Path to DB file for `sqlite`. DB name for `mysql` and `pgsql`.	required
APP_NAME=Lychee	The gallery name.	optional
APP_URL=	The URL you will use to access Lychee including protocol, and port where appropriate.	optional
TRUSTED_PROXIES=	Set to the IP or netmask covering your reverse proxy, if running behind one. Set to `` to trust all IPs (do not* use `*` if exposed to the internet`).	optional

Volumes
Path	Function	Required
/config	Persistent config files.	required
/pictures	Where lychee will store uploaded images.	required

Architectures

Pulling :latest picks the right one for your host automatically.

x86_64amd64-latest
arm64arm64v8-latest

Changelog

5 Jul 2026
Rebase to Alpine 3.24.
9 Jul 2025
Add php84-ldap as dependency.
9 Jul 2025
Rebase to Alpine 3.22.

Browse all

piwigo

16.4.0-ls362

piwigo is a photo gallery software for the web that comes with powerful features to publish and manage your collection of pictures.

80.4K149arm64

digikam

9.1.0-ls331

digiKam: Professional Photo Management with the Power of Open Source

26.6K79

darktable

25.6.2-1-ls233

darktable is an open source photography workflow application and raw developer. A virtual lighttable and darkroom for photographers. It manages your digital negatives in a database, lets you view them through a zoomable lighttable and enables you to develop raw images and enhance them.

15.7K38arm64