What are database connections?

A database connection in the web application is a record of a governed database target: a name, an environment label such as Development or Production, optional metadata, and an identifier. It holds no JDBC URL and no credentials, and it never connects to anything. Connecting Liquibase to your database happens in your CLI configuration; this record exists so operations against that database can be attributed and reviewed.

The database connections dashboard

The dashboard lists every registered connection with its environment badge. New Connection opens the registration form, where you pick the database type and environment.

The database connection details page

Opening a connection shows its identifier, environment, associated projects, and the operations attributed to it. This is where drift detections for a database surface alongside its deployment history.

The Database Connections dashboard

The Database Connections dashboard lists all database connections registered in your the server account. For each connection, you can see its name, identifier, database type, environment, policy status, the date it was created, and when it was last used.

You can search for a connection using the Filter database connections search bar, and narrow the list using the Type and Environments dropdown filters. Toggle Show Archived to include archived connections in the list.

Connection fields

The Database Connection details page

Selecting a database connection from the Database Connections dashboard opens its detail page. This page gives you a complete view of the connection's configuration, properties, policy check status, drift detection status, and operation history.

At the top of the page you can see the connection name, its environment badge, and its identifier. From here you can also:

• Edit — update the connection's name, environment, and database type

• Clone — create a new connection based on this one

• Archive — remove the connection from the active list

• Generate Audit Report — export a report of operation activity for this connection

Note: Archiving a connection hides it from the projects and pipelines it belongs to, and from their connection counts, without removing it from them. Restore it and it reappears in each one, in its original place in every pipeline.

Database Information

Shows the technical details of the database this connection points to.

Policy Checks

Policy check status for this connection will be available in a future release.

Drift Detection

Drift detection status for this connection will be available in a future release.

Properties

Custom key-value properties associated with this connection, such as the Liquibase version used against it. Select + Add Property to add a new property. Use the edit and delete icons on each row to update or remove an existing property.

Changelog Summary

Changelog execution statistics for this connection will be available in a future release.

Operations History

Lists every Liquibase operation run against this connection. You can search using the Filter operations bar and narrow the list by Status or Type.

Tags

Lists the tags assigned to this connection, shown as rounded badges at the bottom of the page. A tag can carry its own color, which the badge uses for its border and text.

This section appears only when the connection has at least one tag. A connection with no tags does not show an empty Tags card.