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