Enable Liquibase License Tracking

Last updated: October 13, 2025 Liquibase License Tracking is currently in Public Preview (beta). Features and capabilities may change based on customer feedback. For assistance or updates, contact Liquibase Support.

Liquibase License Tracking (LLT) allows Liquibase Secure 5.0 users to monitor and report on their license utilization locally across teams, environments, and CI/CD pipelines. This feature provides visibility into active vs expired licenses, compliance risks, operational inefficiencies, and historical insights. Once enabled, this functionality allows you to produce an easy-to-analyze License Tracking report that contains:

  • The number of licenses tracked

  • Active licenses

  • Active licenses nearing expiry

  • Expired licenses

  • Total number of licenses

  • Total number of unique targets for active licenses

  • License inventory and utilization

  • A breakdown of the active license usage per tracking ID

Liquibase License Tracking

Procedure

To use Liquibase License Tracking, simply enable it within your existing Liquibase Secure installation.

The Liquibase License Tracking distributable is located in the dist folder inside your Liquibase installation.

1

Start the server.

Run this command in the CLI: $ ./start.sh You will see the server start within your terminal.

2

Open another instance of the CLI and navigate to where you store your changelog and liquibase.properties file.

3

Enable license tracking with any of these methods:

 This can be done in your liquibase.properties file, as an environment variable, or in the CLI to turn on LLT.

Add this to your liquibase.properties file:

####### Liquibase License Tracking
--license-tracking-enabled=true

4

Set the --license-tracking-url=<insert-your-url-here>

This URL is where your LLT application is accessible.

5

Run the status command in the CLI:

This command uses a tracking ID to display if license tracking is enabled and running properly. The tracking ID is the user name associated with the PostgreSQL database. Learn more about the username at pgadmin.org

-–license-tracking-tracking-id jane status

Navigate back to the terminal running LLT to see the log. In particular, you should note the Processing LicenseTrack item. That confirms that LLT is implemented correctly.

6

To confirm Liquibase is running, turn up the logging level.

Run the status command on the LLT by running this command: 

liquibase
--license-tracking-url=https://localhost:9090 
--license-tracking-log-level severe –log-level severe status

Results

In the CLI you can see that Liquibase obtains license tracking, which include the database type, URL logging location, license key, and the user name.

Enable Liquibase License Tracking - Liquibase