Configuring Signavio Process Manager

Before you can start the web application, you need to configure the Signavio server. The ZIP archive contains the configuration file template configuration.xml.

The location of the configuration files changed with version 9.7.0. Follow the instruction in the Updating Signavio Process Manager section to move the files to the new location.

  1. Place the following files into the conf directory of your Tomcat instance $TOMCAT_DIR/conf:
    • configuration.xml
    • configuration_signed.xml
    • simulation.xml
  2. In the configuration.xml file, adjust the following properties:
Property   Possible values


The URL of the target server. The URL must not end with a / (slash).

Format: http(s)://<DNS entry or IP address>(:<port>),


The default language of the system. When working in a multi-language workspace, the value defines the default language.

For example, if a user is invited to comment on a model, the Collaboration Hub will be displayed in the default language. Once the user logs in, the Collaboration Hub is displayed in the language defined in the user settings.
Possible values are the following:

  • de (German)
  • en (English)
  • es (Spanish)
  • fr (French)
  • ja (Japanese)
  • ko (Korean)
  • nl (Dutch)
  • ru (Russian)
  • zh (Chinese)

Database configuration

The template configuration file already contains a default configuration for the connection to a MySQL database. Use those defaults and configure the variables URL, user name and password.


driverClass: The Java class name of the JDBC driver.


url: The URL of the database system


(You are connecting to the MySQL server named localhost and the database signavio.)

username : The username of the database user account.


password: The password of the database user account.


dialect: Hibernate specific SQL dialect.

  • MySQL : org.hibernate.dialect.MySQL5InnoDBDialect

Email server configuration

Configure the connection to an email sever that will send out system emails like notifications and registration emails.

  • SMTP_HOST_NAME : Host name of the email server
  • SMTP_EMAIL: Sender mail addresses for outgoing emails
  • SMTP_AUTH_USER : Username of the email account to be used
  • SMTP_AUTH_PWD: Password of the email account to be used
  • SMTP_PORT: Port the email server uses
  • SMTP_SECURE: Usage of TLS/SSL. Possible values are true and false
Optional configurations

The absolute path to an existing folder on the target server. The system user who runs the Tomcat Server needs to have write access to this directory. The path must be outside of the webapps directory, because during an update of Signavio Process Manager the content of the webapps folder is removed. This folder contains files that are cached during run-time of the application. You don't need to backup the content of this folder.

Support email address:
This is the receiving address of the support request users can send through the support form out of Signavio Process Manager. If this attribute is empty, the Signavio support address will be used.

Insert the email address of your contact person, for example


Maximum diagram count for reports configuration:


Add the tag <maxDiagramCount> to set the maximum number of diagrams.

The default value is 250.

In this example, the value is increased to a maximum of 500 diagrams:


Performance related configuration Add the tag <inMemoryCacheMaxEntries> to set the maximum number of cache entries.
The default value is 1000.
Use a lower number if the system uses too much main memory (RAM). Use a higher number if the system is too slow.

Add the tag <inMemoryCacheExpirationTimeAfterAccess> to set the cache expiration time.

The default value is 172800 (in seconds).

Use a lower number if the system uses too much main memory (RAM). Use a higher number if the system is too slow.
For more information, please contact Signavio Support.
  1. In the same directory, add the following lines to the file context.xml inside the <Context> tag :
<Parameter name="configfile"

  value="${catalina.base}/conf/configuration.xml" />

<Parameter name="licensefile"

  value="${catalina.base}/conf/configuration_signed.xml" />

<Parameter name="configfile.simulation"

  value="${catalina.base}/conf/simulation.xml" />
  1. Check if the system user that runs the Tomcat has access to newly copied files. If this is not the case, update the corresponding permissions accordingly.
  2. Start the Tomcat server.
    • You can now access Signavio Process Manager in a web browser via the DNS entry or the IP address configured (for example,

If you want to change the configuration later, you need to restart the Tomcat server to apply any changes.

Signavio automatically provides customers of the on-premises edition with a new license once the old license expires.