Install Liquibase on macOS

Before you begin

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

Automatic

  1. Navigate to your preferred Liquibase installer:

    • For Liquibase Pro users, you have the option to use our new Pro-only installer. This version requires a paid Liquibase license key.

    • For Liquibase OSS users, or Pro users who are not ready to move to our Pro-only distribution, use our Liquibase OSS installer.

  1. Select download.

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

Manual

  1. Navigate to your preferred Liquibase installer:

    • For Liquibase Pro users, you have the option to use our new Pro-only installer. This version requires a paid Liquibase license key.

    • For Liquibase OSS users, or Pro users who are not ready to move to our Pro-only distribution, use our Liquibase OSS installer.

  2. Select download.

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

  3. Extract the contents to a local directory.
  4. (Optional) Add the Liquibase installation directory to your system PATH. Open the ~/.bashrc file (if you use Bash) or ~/.zshrc (if you use Zsh) and add this line:
  5. Example: export PATH=$PATH:<path to liquibase installation>

    Restart the shell session to load the new changes.

  6. From a command line or terminal, type liquibase --version to verify that Liquibase has been installed successfully.

Homebrew

The Pro-only distribution of Liquibase available with release 4.32.0 is not available via Homebrew. You can, however, still access and Liquibase Pro functionality by using the version of Liquibase available within Homebrew by adding your valid Liquibase Pro license key.

To install Liquibase with the Homebrew package manager, follow these steps:

  1. Install Homebrew if you have not done so already.
  2. In your command line, run the following command:
  3. brew install liquibase

Need help? See Installation Troubleshooting.

Next steps

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