Prerequisites

• You must have a database docker running OR create one in your docker-compose.yml.

Image content

This image features Lychee (Laravel version), nginx and PHP-FPM.

Note that nginx will accept by default images up to 100MB (client_max_body_size 100M), according to the recommendations of the Lychee-Laravel FAQ. However, to upload large files, you will need to modify php.ini directives as well (see FAQ). To do so, please mount your custom php.ini file to /etc/php/7.3/php/php.ini.

Setup

1. Create the db, username, password.
2. Edit the environment variables:
   • Supply the environment variables via docker run / docker-compose, or
   • Create a .env file with the appropriate info and mount it to /conf.

Available Docker Tags

• latest: current stable tag
• v[NUMBER]: stable version tag
• dev: current master branch tag
• testing: branch and pr tag for testing

Example docker run command

1. Make sure that you link to the container running your database!!
   The example below shows --net and --link for these purposes
   --net connects to the name of the network your database is on
   --link connects to the database

docker run -d \
--name=lychee-laravel \
-v /host_path/lychee-laravel/conf:/conf \
-v /host_path/lychee-laravel/uploads:/uploads \
-e PUID=1000 \
-e PGID=1000 \
-e PHP_TZ=America/New_York \
-e DB_CONNECTION=mysql \
-e DB_HOST=mariadb \
-e DB_PORT=3306 \
-e DB_DATABASE=homestead \
-e DB_USERNAME=homestead \
-e DB_PASSWORD=secret \
-p 90:80 \
--net network_name \
--link db_name \
bigrob8181/lychee-laravel

Warning : if you use a MySQL database, make sure to use the mysql_native_password authentication plugin, either by using the --default-authentication-plugin option when starting mysql, or by running a query to enable the authentication plugin for the lychee user, e.g. :

alter user 'lychee' identified with mysql_native_password by '<your password>';

Example docker-compose.yml

Change the environment variable in the provided example to reflect your database credentials.

Note that in order to avoid writing credentials directly into the file, you can create a db_secrets.env and use the env_file directive (see the docs).

Available Environment Variables and defaults

If you do not provide environment variables or .conf file, the example env file will be used with some values already set by default.

Some variables are specific to Docker, and the default values are :

• PUID=1000
• PGID=1000
• USER=lychee
• PHP_TZ=America/New_York