mongodb-retry-writes
Last updated: September 2, 2025
--mongodb-retry-writes is a global parameter for the Liquibase MongoDB Open Source extension. It specifies whether to retry write operations a single time after a failed write. If true, Liquibase appends retryWrites=true to the connection URL. If false, Liquibase appends retryWrites=false. The default value is true.
Uses
Setting this parameter to false permits Liquibase usage on MongoDB versions not supporting retryWrites, like Amazon DocumentDB.
Syntax
You can set this parameter in the following ways:
Option | Syntax |
Liquibase properties file (defaults file) | liquibase.mongodb.retryWrites: <true|false> |
Global flow file argument (example) | stages: Default: actions: - type: liquibase command: update globalArgs: { mongodb-retry-writes: "<true|false>" } |
Global CLI parameter | liquibase --mongodb-retry-writes=<true|false> update --changelog-file=example-changelog.xml |
JVM system property JAVA_Opts Environment Variable | Unix: JAVA_OPTS=-Dliquibase.mongodb.retryWrites=<true|false> Windows: JAVA_OPTS=-D"liquibase.mongodb.retryWrites=<true|false> |
Liquibase environment variables | LIQUIBASE_COMMAND_CHANGELOG_FILE=<string> |
For more information, see Working with Command Parameters.