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

Be sure you have Ansible set up on your machine.
Install Java.
View additional requirements.

Procedure

Install the Role

Install the Liquibase role from Ansible Galaxy:

ansible-galaxy role install liquibase.liquibase

If you instead need to update the role, run:

ansible-galaxy install --force liquibase.liquibase

To uninstall the role:

ansible-galaxy role remove liquibase.liquibase

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

Create a Playbook

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

- name: Install Liquibase
  hosts: liquibase_hosts
  become: 'yes'
  roles:
    - liquibase.liquibase

This installs the latest default version of Liquibase.

To install a specific version, include the liquibase_ver variable.

- name: Install Liquibase 4.26.0
  hosts: liquibase_hosts
  become: 'yes'
  roles:
    - role: liquibase.liquibase
      liquibase_ver: 4.26.0

Run the Playbook.

Use the ansible-playbook command to apply the role.

ansible-playbook -i inventory.ini playbook.yml

Verify Installation

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

liquibase --version

This confirms Liquibase is installed and available.