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.
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
Install the latest version
Install the latest stable version of Liquibase via Node Package Manager (NPM).
npm install --save liquibase(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.
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
(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.