Introducing Agent Safe Governance for the AI Era

Read the Blog

Enable Liquibase License Tracking

Last updated: March 12, 2026

Liquibase License Tracking is currently in Public Preview. Features and capabilities may change based on customer feedback. For assistance or updates, contact Liquibase Support. Liquibase License Tracking - Public preview (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

Before you begin

A DNS hostname must be configured for the LLT Server before proceeding. The hostname must resolve correctly from all client machines that will use Liquibase.

Required Port: Port 8080 must be open and accessible from all client machines. LLT must be configured to run on port 8080 to work with Liquibase's default tracking URL. Work with your infrastructure team to:

  • Create a DNS record that points liquibase-tracking.local to your LLT Server's IP address.

  • Verify the hostname resolves from client machines

  • Ensure firewall rules allow traffic on port 8080

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

Configure your LLT port

Ensure the port LLT runs on is set to 8080:

Set the SERVER_PORT Environment variable on your LLT host server.

export SERVER_PORT=8080

set SERVER_PORT=8080

$env:SERVER_PORT=8080

Add -e SERVER_PORT=8080 to your docker run command

Docker
loading
2

Extract and start the server.

1. Navigate to the dist folder inside your Liquibase installation.

cd liquibase-secure-5.0.2/dist

2. Unzip the license tracking package.

tar -xzf liquibase-license-tracking-1.0.0-beta.tar.gz

3. Navigate to the extracted directory and start the server.

cd liquibase-license-tracking-1.0.0-beta $ ./start.sh

The server will start and run by default on port 8080. You should see output indicating the server is running at http://localhost:8080/. Leave this terminal window open so the server can run.

Example output

Tomcat started on port 8080 (http) with context path '/' Started LiquibaseLicenseTracking in [X] seconds...

3

Configure your liquibase project.

1. Navigate to your Liquibase project directory. This will be the directory where your liquibase.properties file and changelog are located. This should be separate from your installation directory.

2. Enable license tracking in your liquibase.properties file.

Be sure to:

  • Replace localhost:8080 with your license tracking server URL.

  • Replace your-unique-id with a unique identifier for this Liquibase instance. This could be an environment name, user name, or team name.

loading

loading

loading
4

Test License Tracking

1. Run a Liquibase command to test that license tracking is working.

loading

2. Verify license tracking is working by checking the LLT server terminal. Liquibase sends tracking data in the background with no additional output in your Liquibase terminal. In the LLT server terminal, you will see incoming HTTP request activity confirming that tracking data was received.

Example output
loading

Next step

Once you have successfully enabled license tracking, you can generate comprehensive reports on your license usage.