mongodb-adjust-tracking-tables-on-startup

Last updated: January 30, 2026

--mongodb-adjust-tracking-tables-on-startup is a global parameter for the Liquibase MongoDB Open Source extension. It specifies whether to validate the Liquibase DATABASECHANGELOG and DATABASECHANGELOGLOCK collections on startup. If they are not up to date with the current release, Liquibase adjusts them. The default value is true.

Uses

It is a best practice to keep this parameter enabled whenever you upgrade to a new Liquibase version.

Syntax

You can set this parameter in the following ways:

Option

Syntax

Liquibase properties file (defaults file)

liquibase.mongodb.adjustTrackingTablesOnStartup: <true|false>

Global flow file argument (example)

stages: Default: actions: - type: liquibase command: update

globalArgs: { mongodb-adjust-tracking-tables-on-startup: "<true|false>" }

Global CLI parameter

liquibase --mongodb-adjust-tracking-tables-on-startup=<true|false> update

--changelog-file=example-changelog.xml

JVM system property JAVA_Opts Environment Variable

Unix:

JAVA_OPTS=-Dliquibase.mongodb.adjustTrackingTablesOnStartup: <true|false>

Windows:

JAVA_OPTS=-D"liquibase.mongodb.adjustTrackingTablesOnStartup: <true|false>

Liquibase environment variables

LIQUIBASE_MONGODB_ADJUST_TRACKING_TABLES_ON_STARTUP=<true|false>

mongodb-adjust-tracking-tables-on-startup - Liquibase