Skip to main content
Version: Next

Flags

Flags allow you to control the availability of certain features within Desktop Modeler. Learn which flags are available and how to configure them.

Configuration​

You may configure flags in a flags.json file or pass them via CLI.

Configuration via flags.json​

note

Configuration changes via flags.json will only take effect once you restart the application.

Place a flags.json file inside the resources folder of your local {USER_DATA} or {APP_DATA_DIRECTORY} directory to persist them.

Configuration via command line​

Pass flags via the command line when starting the application.

"Camunda Modeler.exe" --disable-plugins

Flags passed as command line arguments take precedence over those configured via a configuration file.

Available flags​

flagdefault value
"disable-plugins"false
"disable-adjust-origin"false
"disable-cmmn"true
"disable-dmn"false
"disable-form"false
"disable-httl-hint"false
"default-httl"false
"disable-platform"false
"disable-zeebe"false
"disable-remote-interaction"false
"single-instance"false
"user-data-dir"Electron default
"display-version"undefined
"zeebe-ssl-certificate"undefined
"c7-engine-version"undefined
"c8-engine-version"undefined
"enable-new-context-pad"false
"disable-connector-templates"false

Examples​

Disable plug-ins​

Start the modeler without activating installed plug-ins. This is useful to debug modeler errors.

BPMN-only mode​

To disable the CMMN and DMN editing capabilities of the App, configure your flags.json like this:

{
    "disable-dmn": true,
    "disable-form": true
}

As a result, the app will only allow users to model BPMN diagrams.

BPMN only mode

Disable history-time-to-live hint​

Camunda 7 only

To disable the history time to live hint in scenarios where the engine configures HTTL, configure flags.json:

{
    "disable-httl-hint": true
}

Default history-time-to-live​

Camunda 7 only

To set a default history time to live value to be used in newly created models, configure flags.json:

{
    "default-httl": 30
}

Custom display-version label​

To display a custom version information in the status bar of the app, configure flags.json:

{
    "display-version": "1.0.0"
}

Custom version info

Zeebe SSL certificate​

Camunda 8 only

ℹ️ Modeler will read trusted certificates from your operating system's trust store.

Provide additional certificates to validate secured connections to a Camunda 8 installation.

Configure your flags.json:

{
    "zeebe-ssl-certificate": "C:\\path\\to\\certs\\trusted-custom-roots.pem"
}

Additional information adapted from the upstream documentation:

The peer (Camunda 8) certificate must be chainable to a CA trusted by the app for the connection to be authenticated. When using certificates that are not chainable to a well-known CA, the certificate's CA must be explicitly specified as trusted or the connection will fail to authenticate. If the peer uses a certificate that doesn't match or chain to one of the default CAs, provide a CA certificate that the peer's certificate can match or chain to. For self-signed certificates, the certificate is its own CA, and must be provided.

Default execution platform version​

To change default execution platform version, configure your flags.json as follows:

{
  "c7-engine-version": "7.18.0",
  "c8-engine-version": "8.0.0"
}

New diagrams created in Desktop Modeler will use the configured version instead of the latest stable version.

Enable new context pad​

To use the new context pad, configure your flags.json as follows:

{
  "enable-new-context-pad": true
}

New context pad

Disable Connector templates​

Camunda 8 only

To disable automatic Connector template fetching, configure your flags.json as follows:

{
  "disable-connector-templates": true
}