Install Liquibase on Windows

Last updated: September 2, 2025

Before you begin

Confirm that Java is installed. If you use the Liquibase Installer, Java is included automatically.

Procedure

1

Download Liquibase.

2

Select download to run the installer.

If the Liquibase Installer does not start automatically after downloading, locate the Installer file in your Downloads directory and run it.

Note: If Windows security prevents the Liquibase Installer from running, click Run Anyway. Depending on your version of Windows, you might need to click More info first.

Note: If you downloaded a .zip or .tar.gz archive instead of an installer, extract the contents to a local directory.

3

Apply your Liquibase Secure license key.

Using a Secrets Management tool like Hashicorp Vault or AWS Secrets Manager is best to keep Liquibase license keys secure.

There are several ways to apply the Liquibase Secure license key:

Include the Liquibase Secure license key in the Liquibase properties file and save it.

For example:

liquibase.licenseKey: aei76ou32thp785463214

4

Add Liquibase to your system PATH.

To run Liquibase commands from any terminal window, you must add the Liquibase /bin directory to your system PATH. For detailed instructions, Windows users can follow the official Microsoft documentation.

When following this guide, be sure to:

  • Use the full path to the /bin directory inside the folder where you extracted. For example: /usr/local/liquibase/bin

  • Do not delete any existing values in the PATH. Just add your Liquibase path to the end, separated by a semicolon.

5

Verify Liquibase has been added to your system PATH.

Once added, open a new Command Prompt and run:

liquibase --version

If it returns the version number, Liquibase is installed and ready to use.