Introducing simpler ways to install & manage Liquibase

Our goal at Liquibase is to help you automate database change management so you can code at full speed, ship confidently and quickly, and spend more time innovating and less time on tedious, manual tasks. So, we’ve launched a new initiative to make it faster and easier to install and manage Liquibase.

Say goodbye to the manual process of downloading the archive, extracting files, and setting up the path— with our new installer packages, installing and managing Liquibase is easier than ever. 

Benefits include:

• Simplicity: No more manual extraction or path configuration steps.
• Ease of use: A straightforward installation process that saves time and effort.
• Consistency: Leverage the power of package management, ensuring a standardized installation across systems.
• Efficiency: Seamless upgrades with a simple command.
• Community support: Access to a vibrant Liquibase community for assistance and guidance.

Docker

Installing and running Liquibase using Docker is a streamlined process that provides flexibility and efficiency. In this section, we’ll cover how you can use Docker to install and manage Liquibase.

There are two primary Docker images available:

• Standard: This is ideal for most use cases.
  liquibase:<version>

• Alpine: This is a lightweight version with a smaller footprint that’s suitable for environments with limited resources.
  liquibase:<version>-alpine

The Alpine image can be extended to include additional tools that are not included by default. Check out these examples to learn more. 

Changelog File: The Docker image contains a /liquibase/changelog volume, where you’ll mount the directory containing your ChangeLog root. When running Liquibase commands, your --changeLogFile argument should point to paths relative to this volume.

Here’s an example—if you want to update a local ChangeLog, you would run:

docker run --rm -v c:\projects\my-project\src\main\resources:/liquibase/changelog liquibase/liquibase --changeLogFile=changelog/com/example/changelogs/root.changelog.xml update

Configuration File: If you’re using a liquibase.properties file, include it in your changelog volume mount to specify arguments. When you specify a custom Liquibase properties file, be sure to include searchPath=/liquibase/changelog in it to direct Liquibase to the correct ChangeLog files.

Check out our documentation to learn more about installing and managing Liquibase with Docker.

Ubuntu / Debian

To install Liquibase using the Debian/Ubuntu installer package, follow the steps below:

1. Open a terminal.
2. Run the following command to import the Liquibase GPG key and add the Liquibase repository to the apt sources list:
   wget -O- https://repo.liquibase.com/liquibase.asc | gpg --dearmor > liquibase-keyring.gpg && \
cat liquibase-keyring.gpg | sudo tee /usr/share/keyrings/liquibase-keyring.gpg > /dev/null && \
echo 'deb [arch=amd64 signed-by=/usr/share/keyrings/liquibase-keyring.gpg] https://repo.liquibase.com stable main' | sudo tee /etc/apt/sources.list.d/liquibase.list

3. Update the package lists:
   sudo apt-get update

4. Install Liquibase:
   sudo apt-get install liquibase

That’s it! If you want to install a specific version of Liquibase, run the following command and replace x.y.z with the desired version number:

sudo apt-get install liquibase= x.y.z

To upgrade Liquibase to the latest version, follow these steps:

1. Open a terminal.
2. Update the package lists:
   sudo apt-get update

3. Upgrade Liquibase:
   sudo apt-get upgrade liquibase

Check out our documentation to learn more about installing and upgrading Liquibase on your Linux machine with Ubuntu / Debian.

Red Hat / CentOS

We’re excited to announce our latest package manager for Red Hat / CentOS. Check out the steps below to learn how to install Liqubase:

1. Open a terminal.
2. Import the Liquibase public key (as root):
   rpm --import https://repo.liquibase.com/liquibase.asc

3. Add the remote repo to yum (as root):
   yum-config-manager --add-repo https://repo.liquibase.com/repo-liquibase-com.repo

4. Install Liquibase:
   yum install liquibase

Liquibase is now installed! If you want to install a specific version of Liquibase, run the following command and replace x.y.z with the desired version number:

yum install liquibase-x.y.z

To upgrade Liquibase to the latest version, follow these steps:

1. Open a terminal.
2. Update to the latest version:
   yum update liquibase

Check out our documentation to learn more about installing and upgrading Liquibase on your Linux machine with Red Hat / CentOS.

We’re just getting started

Try out our new installer packages and let us know what you want to see next. We’ve got some exciting plans, so keep an eye out for more soon!

Special Thanks to Alejandro Alvarez

We would like to extend a special thanks to Alejandro Alvarez, our talented DevOps Engineer, for his contributions to developing and implementing these installer packages for Liquibase. Alejandro’s expertise and dedication have been instrumental in making the installation process smoother and more accessible for our users.

You can connect with Alejandro on GitHub and explore his projects and contributions.