Installing Liquibase

Software Installation

You can install Liquibase on Windows, MacOS, and Linux/Unix systems:

Software configuration

The Liquibase CLI ships with drivers for many popular database systems in the liquibase/internal/lib directory, including:

  • DB2
  • H2
  • HyperSQL
  • Firebird
  • MariaDB
  • MS SqlServer
  • Oracle
  • PostgreSQL
  • Snowflake
  • SQLite

If you are using a different database system or need to run a different version of the driver, you can download the appropriate driver from your vendor, and install it in one of two places:

  • The lib directory of your Liquibase installation – Drivers added here will always be used by Liquibase
  • A liquibase_libs directory of your current working directory – Drivers added here will only be used when you are in this working directory

If you are using any Liquibase extensions, they can be added to the same directories.

Manual library management

Liquibase comes with two JAR files in liquibase/internal/lib serving as primary libraries, liquibase-core and liquibase-commercial. You need a commercial license key to access functionality for Liquibase Pro and other commercial add-ons. If you aren't using the liquibase-commercial JAR and want to exclude it from your project, navigate to liquibase/internal/lib in your command line and manually remove the file:

Linux/macOS:

rm liquibase-commercial-4.20.0.jar

Windows:

del liquibase-commercial-4.20.0.jar

For more information about individual Liquibase files, see Liquibase Installation Files.

More information

Need help? See Installation Troubleshooting.

For more information about installing Liquibase, see the following pages: