How to Apply Your Liquibase Pro License Key
Liquibase Pro offers all the functionality of Liquibase Open Source as well as the following features:
- Targeted rollbacks for one change or set of changes
- Enhanced stored logic capabilities
- Database drift detection
- Quality Checks
- Native executors for PSQL, SQL Plus, and SQLCMD
- Remote file access with S3
- Secrets Management
- Portable and centralized workflows
- Structured Logging
- Operation Reports
For more information, see Liquibase Pro Workflows.
Note: To take advantage of all Liquibase Pro features, it is recommended to use the latest version of Liquibase.
Apply your Liquibase Pro license key
Tip: It is best to use a Secrets Management tool like Hashicorp Vault or AWS Secrets Manager to keep Liquibase license keys secure.
There are several ways to apply the Liquibase Pro license key:
- liquibase.properties file
- CLI Argument
- Environment Variable
- Java Opts Environment Variable
- Docker Container
- properties of pom.xml file
- Azure DevOps pipeline
liquibase.licenseKey: aei76ou32thp785463214
liquibase --license-key=[paste the Liquibase Pro license key] [command]
For example:
liquibase --license-key=aei76ou32thp785463214 update
On Windows:
set LIQUIBASE_LICENSE_KEY=aei76ou32thp785463214
On Linux/macOS:
export LIQUIBASE_LICENSE_KEY=aei76ou32thp785463214
JAVA_OPTS="Dliquibase.liquibaseLicenseKey=<enter license key here>"
For more information, see Liquibase Environment Variables.
--env
in the command.docker run --env LIQUIBASE_LICENSE_KEY=<enter license key here>... \
-it liquibase/liquibase:latest sh
<properties>
section of your pom.xml
file:<liquibase.liquibaseLicenseKey>key-goes-here</liquibase.liquibaseLicenseKey/>
For example:
<plugin>
<groupId>org.liquibase</groupId>
<artifactId>liquibase-maven-plugin</artifactId>
<version>0-SNAPSHOT</version>
<configuration>
<changelog-file>com/example/changelog_v4.6.xml</changelog-file>
<liquibaseLicenseKey>key-goes-here</liquibaseLicenseKey>
</configuration>
</plugin>
LIQUIBASE_LICENSE_KEY
in your Azure DevOps pipeline setting file:script: |
echo "Running Quality Checks"
liquibase checks run --changeLogFile=mysqlChangelog.xml
displayName: 'Run Quality Checks'
env:
LIQUIBASE_LICENSE_KEY: $(LiquibaseKey)
In this example, LiquibaseKey
is the name of the Azure DevOps project variable whose value is the license key.
To verify that your Liquibase Pro license key works as expected and to check its expiration date, you can run the status command.
Note: The syntax liquibase.pro.licenseKey
(rather than liquibase.licenseKey
) is deprecated by Liquibase, but still works.