Flowable Work Quick Installation Instructions
These instructions are for Flowable Core Infrastructure, which includes Flowable Design, Flowable Forms, and Flowable Control. The following steps are to install and configure the Flowable Design and Flowable Control applications. The Flowable Core engines are part of your own application and need no license file.
Make sure that you have a valid license file named
.flowable folder of your home directory.
On Unix / MacOS this would be in
~/.flowable. The location for
finding the license file is configured in an
You can download Elasticsearch 6.x from
Once the package is downloaded you should unpack it and then run it by
bin\elasticsearch.bat on Windows).
By default elasticsearch will run in the foreground and will print the
logs in the console. You can stop it by pressing
You can test that elasticsearch is running by sending an HTTP GET
request to port
localhost or by going to
http://localhost:9200/ in your browser.
You can download Tomcat from here.
Once you download the package you should unpack it.
The Tomcat is started by running
bin/catalina.bat on Windows.).
Do not run Tomcat yet; first follow the steps for installing the Flowable WARs.
If you do not already have access to the following WAR files, please contact your Flowable representative:
Flowable Work: flowable-work.war.
Flowable Design: flowable-design.war.
Flowable Control: flowable-control.war.
Copy the files into the Tomcat
Copy the file named
application.properties into the Tomcat
This file contains the most common configurations, such as the data source.
By default, an H2 database is created in the
If you want to run with a different database, or use H2 in a different location, follow the instructions in the "Using a Different Database" section of this guide.
You can now start Tomcat by running
bin/catalina.bat on Windows).
Alternatively, you can run
bin/catalina.sh run to have it in the foreground.
You should now be able to access the Flowable Core applications:
You can log in with the user admin and password test. You need to login in every application as the applications use different user stores.
The Flowable applications are Spring Boot 2.1 applications and are
configured in a standard Spring Boot way.
This means that the database can be configured by setting the
following properties to the
application.properties file previously mentioned.
spring.datasource.url=<jdbc url> spring.datasource.driver-class-name=<jdbc driver class name> spring.datasource.username=<username> spring.datasource.password=<password>
application.properties file contains examples for the compatible databases:
Microsoft SQL Server
The Flowable applications do not ship with the JDBC drivers for databases
other than H2. Therefore you need to download the appropriate JDBC driver
and copy the jar into the Tomcat
The Flowable applications create the required database and tables when they start.
The database user (normally,
flowable) needs database schema read-write permissions.