This documentation is about a version that is out of support, here is the latest documentation version.

How about downloading a newer, supported version?

Bonita Studio preferences

Learn about deployment, web and other Bonita Studio preferences, and the Bonita Studio embedded Tomcat configuration.

Bonita Studio preferences

To configure Bonita Studio preferences, click Preferences in the Cool bar.

General preferences


  • Database clean-up: by default, the database (used by Bonita Engine) preserves all data when Bonita Studio exits. You can override this in order to purge all data instead, which may be useful when you are testing processes.

  • Organization load: by default, the default organization is loaded with Bonita Studio starts. You can override this.


  • Coolbar size: Normal (default) or small.

  • Grid options for process diagrams. You can choose to use a grid positioning for all new process diagrams

  • Grid spacing (in centimeters). Default: 0.5

  • Theme: Light or Dark


  • Bonita Studio language.

  • Web applications language: the language to use by default when loading process forms and Bonita Portal


  • The JRE (Java Runtime Environment) to used by default. JRE will be used when compiling and running Java code

Deployment preferences

Run mode

  • Validation: whether to validate the process before it runs. We recommend to keep this option enabled.

Server settings

  • Start engine server lazily: by default, the engine server is started when the Studio starts up. You may choose not to start the engine until it is actually needed, that is, when you first deploy a new process/organization/BDM/…​ or when you launch the UI Designer for the first time.

  • Custom page debug mode: When enabled, custom pages classloader are rebuilt at each call. Can be useful when updating custom page source directly from cache folder (<tomcat_folder>/server/temp/bonita_portal_<id>_@hostname/tenants/<tenantId>/pages/<custompage_folder>)

  • Port number: Studio embedded Tomcat HTTP listening port.

  • Tomcat Maximum memory allocation (in Mb): the maximum memory allocation (Xmx) for the heap of the JVM running the Tomcat server. Default: 512

  • Tomcat JVM additional arguments: additional java arguments to be passed to the Tomcat JVM at startup. e.g.: -XX:+HeapDumpOnOutOfMemory

  • UI Designer JVM options: additional java arguments to be passed to the UI Designer at startup. e.g.: -Xmx256m

Database connectors

  • Manage the JDBC drivers associated with database connectors. You should use that to include JDBC drivers for commercial DBMS (e.g. DB2)

Web preferences


  • Specify the web browser used when a web page is displayed. Note that some application might override this setting and use a different browser


  • HTTP Proxy settings for web access

Other preferences


  • Define the validation to be applied to the different components of your project: Business Data Model, Connector validation, KPI validation, and Processes.

You can activate this option for Business users so that they can create and share processes without worrying about the technical constraints


  • Rename diagram the first time it is saved.

  • Do not show confirmation on connector definition edition.

  • SVN connector: the SVN connector used if you are using a remote SVN repository. Note: if you change this your local working copy might become unstable. To avoid this, commit any outstanding changes before you modify the connector setting, and reinitialize your local working copy after the update

Eclipse Give access to all Eclipse settings (Bonita Studio is based on Eclipse)

Bonita Studio embedded Tomcat configuration

Default configuration

  • Embedded Tomcat listens on the following ports:

    • 8080: HTTP. This value can be modified using Bonita Studio preferences (see above).

    • 8006: shutdown.

    • 8009: AJP.

    • 9091: embedded h2 database server.

  • Bonita Studio also uses the following port:

    • 6969: watchdog

Changing the configuration

You might need to edit the Tomcat configuration files for example to:

  • Configure logging

  • Change listening ports (shutdown, AJP, h2) to prevent conflicts

  • Declare a datasource to connect to a business database

The Tomcat configuration files are located in the Bonita Studio workspace/tomcat/conf folder.

  • To change a port number, edit server.xml.

  • To add a data source, edit context.xml or workspace/tomcat/conf/Catalina/localhost/bonita.xml.

For more details, see the Tomcat documentation.


Symptom: You see the following error in your Studio log file

!ENTRY 4 0 2021-06-11 08:45:59.981
        at Source)
        at Source)
        at Source)
        at Source)
        at Source)

Potential cause

You connect to the internet through Proxy.

Possible solution

You need to configure your HTTP Proxy settings in the Studio Preferences > Web > Proxy.