• Reference
  • Version · 6.0
  • Change Automation Reference

include-system-classpath

Last updated: August 12, 2026

The include-system-classpath parameter is a Boolean that defines whether Liquibase includes the system classpath when resolving classes at runtime. The default value is true.

Uses

The Liquibase classpath refers to locations searched for drivers. Liquibase always includes:

  • Locations in the classpath setting

  • The current directory

  • Files in the liquibase/lib and liquibase/internal/lib directories

When you use the include-system-classpath parameter set to true, Liquibase also includes locations configured within the underlying Java system.

Syntax

You can set this parameter in the following ways:

Option

Syntax

Liquibase properties file (defaults file)

liquibase.includeSystemClasspath: <true|false>

Global flow file argument

globalArgs: { include-system-classpath: "<true|false>" }

Global CLI parameter

liquibase --include-system-classpath=<true|false> update --changelog-file=example-changelog.xml

JVM system property (JAVA_OPTS environment variable)

Unix:

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

Windows:

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

Liquibase environment variable

LIQUIBASE_INCLUDE_SYSTEM_CLASSPATH=<true|false>

Previousinclude-schemaNextinclude-tablespace