Custom Location for bpm-platform.xml Configuration File


Ready to build a BPMN model?

Build your first business process model instantly with Camunda Platform 8.

Join the Camunda Developer Newsletter

Get the latest events, release notes, and product updates straight to your mailbox.

Starting with camunda BPM 7.1.0-alpha4 it is now possible to put the bpm-platform.xml file in a different location. This solves the problem that you have to open the camunda bpm platform EAR module and change the configuration file inside the EAR file if you want to customize your settings.

Note: This post does not apply to the JBoss Application Server distribution since there the process engine configuration is put directly into the JBoss Application Server configuration file (standalone.xml / domain.xml).

You can now put the bpm-platform.xml file in any location and provide the location as an URL. Examples:

  • /home/camunda/.camunda/bpm-platform.xml
  • C:pathtobpm-platform.xml

The location can be set using

  1. A JNDI entry namedjava:/comp/env/bpm-platform-xml. This is particularly useful on websphere application server.
  2. A System Property namedbpm.platform.xml. Can be set when starting the JVM:
  3. An environment variable namedBPM_PLATFORM_XML.

If none of the above is set, we will attempt to load the bpm-platform.xml from the default location which is the classpath in the Glassfish, IBM Websphere, Oracle Weblogic distributions and{CATALINA_BASE} || ${CATALINA_HOME} + /conf/in the apache tomcat distribution.

Read more about it in the docs.

Related Content

Learn why more and more companies are investing in cloud-native technology, and how it can benefit you today.
We’ve enhanced Camunda Optimize to produce more structured data so that it is ready for machine learning, making it easier than ever to take advantage of AI to improve your processes. Learn how.
Learn how to migrate your process flows from Pega to Camunda quickly and easily with this guide, which walks you through how to use our free migration tool.