- Concept
- Version · 6.0.2
- What is Liquibase Secure server?
What is Liquibase Secure server?
Last updated: November 17, 2026
Liquibase Secure server is the central service you deploy inside your own network to get the Liquibase Secure 6.0 web interface. It receives operation data from every machine that runs Liquibase, stores that data, and serves the dashboard your team uses to review it.
Without the server, each developer's Liquibase run is visible only in their own terminal. With the server, every update, rollback, policy check, and drift result lands in one shared dashboard that updates as operations arrive.
Start here
To set up the server for your team, work through these articles in order:
Install Liquibase Secure server to download and verify the CLI, install the server with your license file, and create the administrator account.
Configure Liquibase Secure server, including outbound email, which is off until you set it up.
Configure TLS certificates for Liquibase Secure server to replace the self-signed certificate with one your organization trusts.
Invite and manage users to give your team access to the console.
Connect Liquibase Secure to the server so your Liquibase runs send their operations to it.
The three components
Liquibase Secure server: The central service. It receives operation data from your Liquibase machines, stores it, and serves the web app. Inside the deployment, the server's API listens on port 3000, behind a reverse proxy that the deployment runs, so that all clients connect through a single HTTPS port. You manage the server with the liquibase-platform CLI, which you download for your platform.
The web app: The browser-based dashboard your team uses to review and analyze operations. The web app runs on your server, not on infrastructure hosted by Liquibase. It is served from the server on port 3001 behind the same HTTPS entry point, and users need only a browser and a URL. Nothing is installed on their machines.
The extension: A component bundled with Liquibase Secure on every machine that runs Liquibase commands. After each command completes, the extension collects operation metadata and reports it to the server. Reporting is non-blocking. If the server is unreachable, the Liquibase command still completes, so adopting the server never puts a deployment at risk.
Everything stays in your network
The server, the web app, and all stored data sit inside your network boundary, and your operation data is never sent to a dashboard hosted by Liquibase. By default, installing and updating the server reach the network, because the CLI uses your license file to download the deployment files and pull the server images from Liquibase. A host with no internet access can still install and update. On a machine that can reach Liquibase, copy the images into your own registry and save the deployment files with pull, then run install or update on the offline host with --files and --registry. Licensing itself is offline. The server validates your license file locally, with no call to Liquibase at run time.
How the components communicate
Any connection type is supported, but use HTTPS for production deployments: it encrypts traffic between your Liquibase machines and the server, which matters whenever the server is reachable over a shared network or VPN. See Let's Encrypt for obtaining and installing a certificate. The whole stack runs inside your network boundary.
For the concept-level view of how these pieces fit the wider product, see Understand Liquibase Secure.
Data storage
The server uses two separate PostgreSQL databases. Each has a distinct role and runs as its own instance.
Database | Purpose |
|---|---|
Primary | Stores all application data: operations, changelogs, database connections, users, and workspaces. Runs on PostgreSQL 17. |
Secrets | Stores encrypted database connection credentials in isolation. Running it as a separate instance means a compromise of the primary database does not expose credentials. |
For where to host the server in production, whether an on-premises server, a private cloud VM, or a VPN-protected host, see Hosting options for an internal deployment.
What the server adds to Liquibase Secure
The server provides capabilities a standalone Liquibase installation cannot. Drift detection compares a live database against a reference you supply, which is either another database or a saved snapshot, to identify schema drift between environments. Database connection credentials are stored in an isolated PostgreSQL instance, so a compromise of the primary data store does not expose them.
Where teams run it
Teams run the server on an on-premises server, on a private cloud VM in a private subnet, or on a VPN-protected host. The common property is that the server is reachable by your team and not exposed to the public internet.
What your team needs from you
Once the server is running, give each team member the URL of the web application (for example, https://liquibase.internal.yourcompany.com). They can then connect their Liquibase runs to the server.
Each team member who runs policy checks on their own machine creates a personal access token in the web application. A pipeline uses the service token of a service principal instead. A token is shown once at creation time and cannot be retrieved afterward, so save it when prompted.
User accounts
The server manages its own user database. Each team member registers directly in the web application with an email address and password, and credentials are stored within the application. You do not need to configure LDAP, SSO, or any external authentication system to get started. If your team requires single sign-on for compliance, you can configure it with Microsoft Entra.