Keyboard shortcuts

Press ← or → to navigate between chapters

Press S or / to search in the book

Press ? to show this help

Press Esc to hide this help

Project Settings

Project settings control application runtime behavior, server configurations, language settings, and workflow configuration. MDL provides commands to inspect and modify all settings categories.

Inspecting Settings

-- Overview of all settings
SHOW SETTINGS;

-- Full MDL output (round-trippable)
DESCRIBE SETTINGS;

ALTER SETTINGS

Settings are organized into categories. Each ALTER SETTINGS command targets one category.

Model Settings

Runtime-level settings such as the after-startup microflow, hashing algorithm, and Java version:

ALTER SETTINGS MODEL <Key> = <Value>;

Examples:

ALTER SETTINGS MODEL AfterStartupMicroflow = 'MyModule.ACT_Startup';
ALTER SETTINGS MODEL HashAlgorithm = 'BCrypt';
ALTER SETTINGS MODEL JavaVersion = '17';

Mendix renamed the Java version property between versions — up to 11.6 it is stored as JavaVersion = Java21, from 11.12 as JavaMajorVersion = 21. Write either spelling ('17' or 'Java17'): mxcli stores the value in whichever dialect the project already uses.

Configuration Settings

Server configuration settings like database type, URL, and HTTP port. Each configuration is identified by name (commonly 'default'):

ALTER SETTINGS CONFIGURATION '<Name>' <Key> = <Value>;

Examples:

ALTER SETTINGS CONFIGURATION 'default' DatabaseType = 'POSTGRESQL';
ALTER SETTINGS CONFIGURATION 'default' DatabaseUrl = 'jdbc:postgresql://localhost:5432/myapp';
ALTER SETTINGS CONFIGURATION 'default' HttpPortNumber = '8080';

Constant Overrides

Override a constant value within a specific configuration:

ALTER SETTINGS CONSTANT '<ConstantName>' VALUE '<value>' IN CONFIGURATION '<cfg>';

Example:

ALTER SETTINGS CONSTANT 'MyModule.ApiBaseUrl' VALUE 'https://staging.example.com' IN CONFIGURATION 'default';

Language Settings

Set the default language for the application:

ALTER SETTINGS LANGUAGE <Key> = <Value>;

Example:

ALTER SETTINGS LANGUAGE DefaultLanguageCode = 'en_US';

Workflow Settings

Configure workflow behavior such as the user entity and task parallelism:

ALTER SETTINGS WORKFLOWS <Key> = <Value>;

Examples:

ALTER SETTINGS WORKFLOWS UserEntity = 'Administration.Account';
ALTER SETTINGS WORKFLOWS DefaultTaskParallelism = '5';

See Also