Install and Use the Liquibase Ansible Role

Last updated: September 2, 2025

Use the official Liquibase Ansible role to install Liquibase on your target servers. This role handles downloading, verifying, and placing Liquibase in your desired installation path.

Note: Starting with Liquibase version 4.32.0, we will no longer update this package manager with our latest software download packages.

Before you begin

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

Critical change: If you are an existing Liquibase Secure user, the brew install liquibase formula may still exist from versions before Liquibase 4.33, but the command will not install Liquibase 5.x +. To access the Liquibase Secure features, you must use brew install --cask liquibase-secure to maintain enterprise functionality when upgrading to 5.x.

Procedure

1

Install the Role

Install the Liquibase role from Ansible Galaxy:

ansible-galaxy role install liquibase.liquibase
2

Step up your inventory.

Create an inventory file, such as inventory.ini, and list your target hosts.

[liquibase_hosts]
10.0.0.1
10.0.0.2
10.0.0.3
3

Create a Playbook

Create a playbook file, such as playbook.yml, that uses the Liquibase role

loading
4

Run the Playbook.

Use the ansible-playbook command to apply the role.

ansible-playbook -i inventory.ini playbook.yml
5

Verify Installation

After running the playbook, SSH into your target servers and run:

liquibase --version