Install Liquibase

Software Installation

You can install Liquibase on Windows, MacOS, and Linux/Unix systems that meet the hardware Requirements:

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.23.2.jar

Windows:

del liquibase-commercial-4.23.2.jar

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

Troubleshooting

Need help? See Installation Troubleshooting.

Next steps

Introduction to Liquibase – Dive into Liquibase concepts
Get Started with Liquibase – Learn how to use Liquibase with an example database
Design Your Liquibase Project – Create a new Liquibase project folder and organize your changelogs
Liquibase Database Tutorials – Configure Liquibase to work with your own database
How to Apply Your Liquibase Pro License Key – If you use Liquibase Pro, activate your license