Install Liquibase with Node Package Manager

Last updated: July 14, 2025

Before you begin

  1. Ensure you have the necessary permissions (such as administrator rights) to install, upgrade, or remove software on your system.

  2. Install NPM on your machine.

Procedure

1

Install the latest version

Install the latest stable version of Liquibase via Node Package Manager (NPM).

npm install --save liquibase
2

(Optional) Install a Specific Version

Liquibase is bundled inside each release of node-liquibase, so when you install a specific version of the package, the corresponding Liquibase Core version is included automatically.

Although the version numbers between Liquibase and node-liquibase may not always align exactly (especially for patch updates), the major and minor versions will typically match.

For example:

bashCopyEdityarn add liquibase@4.3

This will install the latest node-liquibase release for the 4.3 series (e.g., 4.3.4), which includes Liquibase Core 4.3.3 bundled inside.

Note: If you want to manage the Liquibase version separately instead of bundled with it, check out the Peer Dependency release.

3

(Optional) Explore an Example Project

Check out this Small Sandbox Project to evaluate changesets and try out node-liquibase with a PostgreSQL database.

It includes startup scripts and TypeScript, JavaScript, and CLI usage examples.