Install Liquibase with Node Package Manager

Last updated: September 2, 2025

Before you begin

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

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

Apply your Liquibase Secure license key.

Using a Secrets Management tool like Hashicorp Vault or AWS Secrets Manager is best to keep Liquibase license keys secure.

There are several ways to apply the Liquibase Secure license key:

Include the Liquibase Secure license key in the Liquibase properties file and save it.

For example:

liquibase.licenseKey: aei76ou32thp785463214

4

(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.