linancn / lca-collaboration-server-docker

Docker file for building an image for the LCA Collaboration Server

Example Docker Setup for the LCA Collaboration Server 2.0

This repository contains a setup for running the LCA Collaboration Server 2.0 in a Docker container. Before you run a setup as described below, you may have to update the download URLs for the LCA collaboration server and its installer in the Docker file first. Then, you can start the collaboration server by executing the following command:

cd lca-collaboration-server-docker
docker compose up

If not done yet, this will build the image for the collaboration server and also fetch images for MySQL and OpenSearch. Then it starts containers for these images in interactive mode.

The setup will use two volumes (db-data and server-data) for storing data. These volumes are created if they do not exist yet:

docker volume ls
# DRIVER VOLUME NAME
# local  lca-collaboration-server-docker_db-data
# local  lca-collaboration-server-docker_server-data

The collaboration server will run on port 8080, thus http://localhost:8080 will bring you to the login page of the collaboration server (the initial admin user is administrator with the password: Plea5eCh@ngeMe, see also the configuration guide.)

For using the search, you first need to enable it in the administration settings under Enabled features: Search. For the URL of the OpenSearch service, you need to set it to http://search:9200:

schema: http
url:    search   # not localhost!
port:   9200

Running in read-only mode with external MySQL Server

To run the collaboration server in read-only mode, build the lca-collaboration-server image with the following command first:

docker build -t lca-collaboration-server .

The MySQL Server parameters can be adapted in the application.properties file:

spring.datasource.url=jdbc:mysql://<HOST>:<PORT>/<MYSQL_DATABASE>
spring.datasource.username=<MYSQL_USER>
spring.datasource.password=<MYSQL_PASSWORD>
[...]

The container can be run with the following command (the MySQL server must be up and running) then:

docker compose -f compose-read-only.yaml up

If you want to run the containers in background instead, just add the -d flag to the command:

docker compose -f compose-read-only.yaml up -d

The setup will use a single volume (server-data) for storing data. This volume is created if it does not exist yet:

docker volume ls
# DRIVER VOLUME NAME
# local  lca-collaboration-server-docker_server-data

Run a stand alone MySQL container

For testing purposes, a MySQL container with different host name and port can be run with the following command:

docker compose -f mysql/compose.yaml up

The database schema is initialized at start.