ProcessM loads configuration at startup from the conf directory and environment variables and ignores any changes
in options occuring in runtime. To reload configuration, please restart ProcessM. Both file-based configuration and
environment variable-based configuration supports the same options. The options configured in files take prcedence
over the same options configured using environment variables.
All user-accessible configuration options are stored in the conf directory. The main configuration file is
config.properties. The configrable properties follow the format key=value, where key id dot-saparated hierarchical
property name, and value is the property value. Lines starting with the hash # symbol are comments.
The same properties can be loaded from the environment variables, however, due to the
limitations of the operating systems
all letters in keys must be converted to uppercase and dots replaced with underscores _. For instance of a database
connection string, a valid setting in config.properties may be given by line:
processm.core.persistence.connection.URL=jdbc:postgresql://host:port/database?user=user&password=passwordwhile the same setting as environment variable is given by:
PROCESSM_CORE_PERSISTENCE_CONNECTION_URL=jdbc:postgresql://host:port/database?user=user&password=passwordThe following reference refers to the keys in the configuration files. Use the above-mentioned key mapping for the use of environment variable-based configuration.
A valid JDBC connection string to the PostgreSQL database with TimeScaleDB extension.
processm.core.persistence.connection.URL=jdbc:postgresql://host:port/database?user=user&password=passwordwhere host and port point at a PostgreSQL instance, database is the name of the main database. user and
password are credentials for accessing the database.
Time amount in minutes for the user to click on the link to reset their password
processm.services.timeToResetPassword=60The base URL of the ProcessM instance. Used in e.g. emails.
processm.baseUrl=http://localhost:2080/Send emails via SMTP if true, otherwise via sendmail (the default).
processm.email.useSMTP=falseThe path to a sendmail-compatible executable to send emails. Used if processm.email.useSMTP=false.
processm.email.sendmailExecutable=/usr/sbin/sendmailThe default value for the sender full name
processm.email.defaultFrom=ProcessMThe envelope sender address
processm.email.envelopeSender=processm@example.comThe directory to store files required by automatic ETL processes and passed to Debezium using
offset.storage.file.filename and database.history.file.filename. By default the current directory.
processm.etl.debezium.persistence.directory=.The maximum numbers of logs, traces, events, respectively, returned by the PQL query in the PQL interpreter view. The
processm.logs.limit.downloadLimitFactor property is a multipier for these limits that applies to event log files
downloaded from the PQL interpreter view.
processm.logs.limit.log=10
processm.logs.limit.trace=30
processm.logs.limit.event=90
processm.logs.limit.downloadLimitFactor=10The delay in milliseconds before an alignment calculation job starts. As alignment calculation is time-consuming, this delay sets the time for collecting ongoing events and changes in the process model and event log before actually running calculations.
processm.enhancement.kpi.alignerkpi.queueDelayMs=5000Controls whether ProcessM runs in the demo mode. It disables some security features. Set to false (the default) for production environments.
processm.demoMode=falseControls whether ProcessM runs in the test mode. For development purposes only. Set to false (the default) for production environments.
processm.testMode=false