Change Intelligence is coming.

Get a First Look

Enable Liquibase License Tracking

Last updated: July 13, 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.

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.

loading

loading

loading

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-<your_version>/dist

  • Note: Be sure to replace your_version with the version of Liquibase you installed.

2. Unzip the license tracking package.

tar -xzf liquibase-license-tracking-<your_version>.tar.gz

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

cd liquibase-license-tracking ./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
loading
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

These are global parameters and must be placed before the liquibase command.

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.