Installation Troubleshooting

Last updated: July 14, 2025

If you cannot run the liquibase --version command successfully, perform the following steps.

Procedure

1

Verification #1: Check your PATH to Liquibase

To verify that you have correctly added the Liquibase folder to your PATH after the upgrade, type env in your Linux Terminal or Windows Command Prompt to display all available PATHs.

2

Verification #2: Check for Java installation

For Liquibase to run correctly, Java must be installed on your Linux, Unix, or macOS operating system. To verify that Java is installed on your computer:

  1. Open your Linux Terminal or Windows Command Prompt.

  2. In the command line window, type java -version. If you see the error message: "-bash: java: command not found", "'java' is not recognized as an internal or external command, operable program or batch file", or "java : The term 'java' is not recognized as the name of a cmdlet, function, script file, or operable program. Check the spelling of the name, or if a path was included, verify that the path is correct and try again", then you need to install Java or add the location of the Java executable to your PATH.

To install Java on your computer:

3

Verification #3: Run the Liquibase validate command

To verify that your existing project changelogs are compatible with your current projects, you can run the Liquibase validate command.

  1. Open your Linux Terminal or Windows Command Prompt.

  2. Run the following:

liquibase validate

Troubleshooting

  • If the validate command produces an error on a specific changeset, examine your changelog carefully. There may be situations where you have fixed a bug, and now you need to check syntax issues.

  • If you are testing a new feature within an XML changelog, ensure that the header next to the XSD field has the current version of Liquibase. For example, if the upgrade is for Liquibase 4.3.1:

loading