Description

This Docker image is for eLabFTW. It runs three services:

• Nginx webserver
• PHP-FPM service
• Cron daemon to execute recurrent tasks (sending notifications)

These services are managed by s6-overlay and are all customized for running eLabFTW.

Tags and branches

The hypernext (dev) branch is built and pushed to Docker Hub on a "push" event as well as on a daily schedule.

The master branch is built for the latest tag on Docker Hub and contains the latest eLabFTW version.

A tag with the latest released eLabFTW version is also pushed. Example: elabftw/elabimg:4.6.0.

Building this image

Set the ELABFTW_VERSION to a tagged release or a branch. The latest stable version can be found here.

DOCKER_BUILDKIT=1 docker build --build-arg ELABFTW_VERSION=X.Y.Z -t elabftw/elabimg:X.Y.Z .

For dev, add --build-arg BUILD_ALL=0 to skip the installation of dependencies and building of assets, because the folder will be bind-mounted to your host anyway.

Usage

An example configuration file for docker-compose can be fetched like this:

curl -so docker-compose.yml "https://get.elabftw.net/?config"

This will download a pre-filled configuration file.

You can then edit this file where all the possible settings are explained in the comments.

For usage of eLabFTW, see documentation.

Reloading a service

/package/admin/s6/command/s6-svc -r /run/service/php
/package/admin/s6/command/s6-svc -r /run/service/nginx

Deleting cache

If there is a CVE fixed upstream, delete build cache with:

gh cache delete --all

Requires GitHub CLI: https://cli.github.com/