Using the Liquibase Installer for Linux/Unix/Mac

By using the Liquibase Installer for Mac, you automatically get all the dependencies, directories, configuration and properties files to get started. It includes everything you need to run Liquibase, including Java.

To install Liquibase with the Liquibase Installer for Mac:

  1. Go to the Liquibase Download page, select the Mac | Unix | Linux tab, and then select [version] Installer for Mac.
  1. Navigate to the location where the installer app was saved.

  2. Open the downloaded installer file to start the install. If you have any issues, see the Troubleshooting installation issues section.

  3. Select Next to start the setup wizard.

  4. Use the default folder /usr/local/opt/liquibase or choose another folder where you want to install Liquibase.
  1. Use the default Add Liquibase to PATH.

  1. Complete the Liquibase installation by selecting Finish.

After installing Liquibase, you can use the files from the examples directory or proceed with the first steps depending on the tool you use.

If you chose to add Liquibase to the PATH, a file named liquibase will be created in the /etc/paths.d folder. The file will be owned by root and read each time you open a new terminal window:

Troubleshooting installation issues

You may encounter issues with the Liquibase Installer file. If you double-click the file and see the following message when opening the installer, select OK and right-click to open it again:

If you see the Open screen, there may be an additional pop-up window. Select Open to proceed.

If you are not the root user, you will be prompted to type in your password to allow the installation to occur.

Now, you can follow the steps from the main instruction.