- Task
- Version · 6.0.2
- Manage
Connect to Liquibase Server
Last updated: November 17, 2026
Connect your Liquibase runs to the server and send your first operation data.
Before you begin
These steps happen in the Liquibase Server web application.
A running server, its URL from your administrator, and a user account. See Manage your account.
If the server is not set up yet, run Liquibase Server locally on your own machine or use an internally deployed server. Both guides are under Set up and configure Liquibase Secure server.
Java 11 or later.
A Liquibase Secure installation. On Liquibase Community the extension stays disabled, so your command runs normally but no operation data is sent.
The address of your server, from your administrator, with
/apion the end. For example,https://liquibase.example.com/api.
Procedure
Install the reporting extension
The reporting extension is bundled with Liquibase Secure 6.0 and later, so there's nothing to download or install. It ships disabled by default; you'll turn it on in Step 4.
Two ways to verify, depending on which piece you mean:
liquibase --versionliquibase-platform statusCreate an account
Create a service token
Liquibase sends operation data with a service token, which belongs to a service principal rather than to you. A personal access token cannot send operation data, so use a service token here even when you first try this on your own machine. You must be a member of the Administrators group to create a service principal.
The console does not create a service principal unless you scope it to at least one project. If the server has no projects yet, create a project first.
In the left navigation, under Administer, select Service Principals, then select Create service principal.
Under Name, enter a name for where Liquibase runs, such as
ci-orders-pipeline. Under Project scope, select the project that holds the connection and changelog you use in Step 4.Select Create & generate token.
Copy the token. It is shown only once, and you need it in Step 4. Then select I've saved the token.
Configure operation reporting
Run a Liquibase command
View in the dashboard
Open your dashboard and navigate to All Operations. You should see the operation you just ran, showing the command name, date and time, and the changelog it ran against.
Select the operation to view its details, including:
The status of the operation and how long it took to run
The database it ran against
The exact command that was executed and the Liquibase version used
Execution logs captured for the operation, providing an audit view of everything that occurred
Note: If you set neither LIQUIBASE_PLATFORM_CONNECTION_IDENTIFIER nor LIQUIBASE_PLATFORM_CHANGELOG_IDENTIFIER, the server refuses the operation and it does not appear here. A service token must name at least one connection or changelog registered in its service principal's projects.