<<  Overview

Execution in a Container (Docker)

This article describes how to run InnoList in an Container Environment (Docker) or using your own version of Java.

Execute InnoList Web (innolist.jar)

InnoList is a Spring-Boot application (innolist.jar). It can a) be easily integrated into a Docker container or b) run manually (using Java).

To execute, follow the following steps:

  • Creating an image from a Dockerfile
  • Execution in a container

Step 1: Download innolist.jar and create Dockerfile

Download the innolist.jar.

Save the innolist.jar in a directory together with the Dockerfile:

  • innolist.jar
  • Dockerfile

Example-Dockerfile: FROM eclipse-temurin:21-jdk ARG JAR_FILE=innolist.jar COPY ${JAR_FILE} innolist.jar WORKDIR /innolist_run ENTRYPOINT ["java","-jar","/innolist.jar"] (Minimum Java Version: 17)

Now use the command to create the image: docker build -t innolist:innolist . Parameter:

  • 1: -t innolist:innolist: Tag command, creates the image in the "repository" innolist with the "tag" innolist
  • 2: . (Point): Find Dockerfile and innolist.jar in this directory
(This is only required once, after which multiple instances can be started based on this image)

Step 2: Execute in Container

This command runs the application in a new container: docker run --name innolist_app -d -p 80:8080 innolist Parameter:

  • --name innolist_app: Name of the container
  • -p 80:8080: Mapping of internal port 8080 (fix) to some custom port (here: 80)

Open application

URL: http://localhost:8080/

Configuration Directory

InnoList saves configuration (and data, as configured) in the personal directory of the operating system user that executes the web server. Depending on the operating system the personal directory differs:

Windows C:\Users\[Windows-User]\.innolist
Linux /home/[Username]/.innolist
Mac OS /Users/[Username]/.innolist

If necessary the directory for configuration/data may be changed in the configuration file system.xml.

Alternative: Start Manually

Use this command to manually start the Spring-Boot application: java -jar innolist.jar (Minimum Java Version: 17)

(optional) The parameter "-Dserver.port=xxx" specifies a different server port (not after "innolist.jar", only effective before it), e.g.: java -jar -Dserver.port=80 innolist.jar java -Dserver.port=9111 -jar innolist.jar

Are these lines

(...) Started Application in x.xxx seconds
INFO (...) Starting InnoList (Server Deployment)
visible in the output then the starting was successful.
Console Window of Started Server

The application is then reachable over http://localhost:8080 .

Terminate

By pressing Ctrl + c in the console window the application is shut down.