Change Intelligence is coming.

Get a First Look
  • Task
  • Version · 5.2.1
  • User guide

Enable Liquibase License Tracking

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

Port: LLT listens on port 8080 by default, and this guide uses 8080 in its examples. You can run LLT on any port you prefer. If you choose a different port, use it consistently in the steps below and set your license tracking URL to match. Whichever port you choose must be open and accessible from all client machines. 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 the port LLT runs on (8080 by default)

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

LLT runs on port 8080 by default. This step is only needed if you want LLT to listen on a different port. If so, substitute your port for 8080 in the examples below.

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

PreviousWhat is Liquibase License Tracking?NextProduce the Liquibase Secure License Tracking Report