wisemapping-open-source/distribution/README.md

# What is WiseMapping ?

Wise Mapping is the web mind mapping open source tool that leverages the power of Mind Maps mixing open standards technologies such as SVG and React.
WiseMapping is based on the same code product supporting [http://www.wisemapping.com].

# How to use this image.

There are multiple ways to run WiseMapping depending on your database configuration preference

## Option 1: Running HSQL within the image storage 

> $ docker run -it --rm -p 8080:8080 wisemapping/wisemapping:latest

Then, open your browser at `http://localhost:8888`. A default user is available for testing `test@wisemapping.org` and password `test`.

***This option, all changes will be lost once the image is stopped. Use it for testing only*** 

## Option 2: Running HSQL with mounted directory

Only one time, copy the empty default out of the container:

> $ mkdir your- db-dir-store-path
> 
> $ docker run --name wiseapp -d --mount type=bind,source=your-db-dir-store-path,target=/var/lib/wise-db wisemapping/wisemapping:latest
> 
> $ docker cp wiseapp:/var/lib/wisemapping/db your-db-dir-store-path
> 
> $ docker stop wiseapp;docker rm wiseapp

Then, execute the container mounting tbe directory:

> $ docker run --mount type=bind,source=your-db-dir-store-path/db,target=/var/lib/wisemapping/db -it --rm -p 8080:8080 wisemapping/wisemapping:latest

## Option 3: External MySQL/PostgreSQL

### Setup database

Depending on the database your want to configure, you can create initialization scripts [here](https://bitbucket.org/wisemapping/wisemapping-open-source/src/develop/config/database/)

### Configure application properties

The next step is configure the WiseMapping for the database and credentials. 
Download `app.properties` configuration file and configure the required sections:

> $ curl https://bitbucket.org/wisemapping/wisemapping-open-source/src/master/wise-webapp/src/main/webapp/WEB-INF/app.properties

### Starting the application

Run the application mounting your previously configured `app.properties`  

> $ docker run --mount type=bind,source=your-file-path/app.properties,target=/usr/local/tomcat/webapps/ROOT/WEB-INF/app.properties -it --rm -p 8080:8080 wisemapping/wisemapping:latest 

# Advanced configuration

## Increase Tomcat memory
> docker run\ 
> --mount type=bind,source<your-file-path/app.properties,target=/usr/local/tomcat/webapps/ROOT/classes/app.properties
> -m 1.5GB -e JAVA_OPTS=" -XX:+PrintFlagsFinal -XX:InitialRAMPercentage=30 -XX:MaxRAMPercentage=80"
> -it --rm -p 8888:8080 veigap/wisemapping:latest