By using the Liquibase installer, you automatically get all the dependencies, directories, config and properties files to get to know Liquibase. It’s a great way to understand the core concepts with a direct command-line introductory experience.

What’s included?

The Liquibase Installer comes with a ton of features to help new users learn the Liquibase Developer Workflow as quickly as possible without practicing on your own databases. Here’s what’s included:

  • Examples directory containing SQL and XML projects with:
    • Pre-written changelogs
    • Pre-written liquibase.properties files
      Note: Both projects use the same setup and examples. The only difference is the changelog type.
  • An Example H2 database
  • AdoptOpenJDK Binaries

Getting Started

To get started, download your database’s JDBC driver to the lib directory, then run the Liquibase script in the root of this directory.

Set your path variable

Windows OS

To set the Path System Variable:

  1. In your Windows Start Menu Search, type env and select the Edit the System Environment option in the Control Panel.
  2. In the System Properties Advanced tab, select Environment Variables.
  3. In the System Variables section, highlight the Path variable and click Edit.
  4. In the Edit environment variable window, select New, then add the path to the  Liquibase-Version#-bin folder.
    Example:  C:/apps/liquibase-3.8.6-bin
  5. Click OK on all windows to close them.

Mac/Linux/Unix OS

To add the directory to your PATH:

  1. Open the Terminal or Linux Command Line.
  2. Run the following command:
    export PATH=$PATH:/path/to/where/you/installed/liquibase

Note: This command will not permanently update your PATH after the termination of your session.

To update your PATH permanently:

  1. Run the following command:
    source ~/.profile or source ~/.bashrc
  2. Restart your MacOS Terminal app or Linux command line.

Note: There is an even more permanent way to set the path using the Terminal app. To permanently set your PATH:

  1. Open your Terminal app and run:  sudo nano /etc/paths
  2. Append the path /path/to/where/you/installed/liquibase at the end of the file.
  3. Ctrl+x, then y for yes to save the file.
  4. You must restart your Terminal for changes to take effect.

Next Up: Let’s set up your workspace