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: Install the latest node-liquibase release:

npm install liquibase # OR yarn add liquibase # OR pnpm add liquibase # OR bun install liquibase

Install a specific Liquibase version npm install liquibase@4.3 # OR yarn add liquibase@4.3 # OR pnpm add liquibase@4.3 # OR bun install liquibase@4.3

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.