LAREX Docker

Docker image for LAREX

Getting Started

These instructions will get you a Docker container that runs LAREX

Prerequisites

Docker (for installation instructions see the Official Installation Guide)

Installing

Get the Docker Image

From Docker Hub:

• Execute the following command docker pull maxnth/larex

or

From Source:

• Clone this repository first and enter the cloned directory with a command line tool.

• Execute the following command inside the directory: docker build -t <IMAGE_NAME> .

or

Use build_template.sh or build_interactive.sh to build from source:

• Copy build_template.sh to e.g. build_local.sh, customize the configuration and run sh build_local.sh.

  or

• Run sh build_interactive.sh and follow the steps in the terminal accordingly.

• Both steps will automatically build the image from source and start the container. When using this some following steps can be ignored.

Initialize Container

With the help of the image a container can now be created with the following command:

docker run \
    -p <LOCAL_PORT>:8080 \
    --name <CONTAINER_NAME> \
    -v <CONFIG_FILE>:/larex.properties \
    -v <BOOK_DIR>:/home/books/ \
    -v <SAVE_DIR>:/home/savedir \
    -it <IMAGE_NAME>

Explanation of variables used above:

• <CONTAINER_NAME> - Name of the Docker container e.g. larex
• <CONFIG_FILE> - Custom larex.properties file (a template is included in this repository). Changes to the larex.properties will be effective after restarting the docker container (in case one is already running). bookpath should not get changed in the larex.properties but only via volumes (unless you change the variables in the Dockerfile as well)!
• <BOOK_DIR> - Directory in which the books are located on your local machine
• <SAVE_DIR>- Directory in which the results are saved. Defaults to <BOOK_DIR> if not set
• <IMAGE_NAME> - Name of the Docker image e.g. maxnth/larex

The container will be started by default after executing the docker run command.

If you want to start the container again later use docker ps -a to list all available containers with their Container IDs and then use docker start <CONTAINER_NAME> to start the desired container.

You can now access the project via following URL: http://localhost:<Port>/Larex/

Updating

From Docker Hub:

Updating the image can easily be done via the docker hub if the image has been previously pulled from the docker hub.

The following command will update the image:

docker pull maxnth/larex