• Reference
  • Version · 6.0
  • Change Automation Reference

mirror-output-to-console

Last updated: August 12, 2026

--mirror-output-to-console is a global Boolean parameter. When set to true, Liquibase mirrors command output to both the specified output file and the console. When set to false, Liquibase either sends command output to the output file (if it exists) or the console (if no output file exists). It is available in Liquibase Secure 4.28.0 and later. The default value is false.

Uses

By default, when you run a command, Liquibase generates human-readable output and sends it to the console (STDOUT). However, if you use the --output-file parameter to specify a file to store command output, Liquibase sends it only to the output file and not to the console.

However, you may wish to send your command output to both the console and your output file. To do this, set --mirror-output-to-console to true. This allows you to receive and process Liquibase operational information in multiple channels in ways that benefit your workflow.

If you don't specify a value for --output-file in the first place, Liquibase just sends command output to the console, so there is no reason to use --mirror-output-to-console.

You can also use the --mirror-console-messages-to-log parameter to send command output to a log file.

Syntax

You can set this parameter in the following ways:

Option

Syntax

Liquibase properties file (defaults file)

liquibase.mirrorOutputToConsole: <true|false>

Global flow file argument

globalArgs: { mirror-output-to-console: "<true|false>" }

Global CLI parameter

liquibase --mirror-output-to-console=<true|false> update --changelog-file=example-changelog.xml

JVM system property (JAVA_OPTS environment variable)

Unix:

JAVA_OPTS=-Dliquibase.mirrorOutputToConsole=<true|false>

Windows:

JAVA_OPTS=-D"liquibase.mirrorOutputToConsole"=<true|false>

Liquibase environment variable

LIQUIBASE_MIRROR_OUTPUT_TO_CONSOLE=<true|false>

Previousmirror-console-messages-to-logNextmonitor-performance