Kwatee web application the is package as a standalone executable jar which does not require. an additional servlet container such as Tomcat or Jetty. Kwatee uses an internal H2 database by defaut but can be configured to use mysql or postgres and runs any operating system with Java 7 or newer. It has been tested on MacOS, Ubuntu and Windows but will run on any other flavor of linux or unix as well.
In either case, Kwatee self-deploys a proprietary and platform-specific agent (kwagent or kwagent.exe). At this time, there are agents for:
Kwatee is not very resource intensive so there is no need to dedicate a full server to it's operations.
|Java||version 1.7 or newer|
|Database||Kwatee uses an embedded H2 by default but you may configure it to use MySQL 5.1+ or PostgreSQL 8.4+.|
Expand the kwatee-distrib-4.0.2 archive. Well refer to the path of the expanded directory as KWATEE_HOME
KWATEE_HOME/kwatee.properties and customize the properties.
|server.port||The port on which the kwatee web application will listen (default 8080)|
|kwatee.repository.path||the path to the repository directory (default: |
|kwatee.jdbc.schema||the name of the kwatee database|
|kwatee.jdbc.user||the kwatee database user|
|kwatee.jdbc.password||the password of the database user|
|kwatee.jdbc.driver||the database driver|
|kwatee.jdbc.url||the jdbc connection url whose format is specific to the jdbc driver|
|logging.path||directory where kwatee.log will be written (default: |
kwatee.repository.path=d:\\kwatee\\repository, or to replace them by forward slashes, i.e.
The default kwatee.properties are suitable for an installation on a file-based H2 database:
The properties below are suitable for an installation on a mysql database:
The properties below are suitable for an installation on a postgresql database:
If you want to configure SSL, you must first generate a key-pair. On linux:
keytool -genkey -alias kwatee -storetype PKCS12 -RSA -keysize 2048 -keystore keystore.p12 -validity 3650Enter the password (
<password>) and additional details for which you are prompted. After that, simply add the following properties in your
server.ssl.key-store=keystore.p12 server.ssl.key-store-password=<password> server.ssl.keyStoreType=PKCS12 server.ssl.keyAlias=kwatee
KWATEE_HOME/kwatee.sh starton windows
KWATEE_HOME\kwatee.bat startand then point your browser to
The web interface will guide you through the steps for creating the database schema which will require you to supply
kwatee.jdbc.password that must have sufficient privileges for creating users and a database.
Once this final step is completed, you'll see Kwatee's login screen. The default administrator user is
admin with password
The following procedure is recommended when upgrading to a new version of kwatee:
KWATEE_HOME/repositorythen move it back from KWATEE_HOME.old to KWATEE_HOME