Getting Started with Liquibase Hub
Liquibase Hub is a secure portal that provides real-time monitoring, reports, and insights into your team's database release automation. It provides centralized visibility into distributed Liquibase operations performed against multiple environments.
The Liquibase CLI app sends information to the Liquibase Hub portal when you run commands that make changes to your database.
Sign up for an account
- Go to the Liquibase Hub portal.
- Sign up for an account.
- Check your email and click a verification link to activate the account.
Tip: If you have already installed Liquibase, skip this step.
Click Download Liquibase and run the installer.
Note: Liquibase automatically detects your operating system and specific installation files to download. To use another operating system, go to the Download page. If you encounter any issues, check the Installation Troubleshooting page.
Configure Liquibase Hub
From the command prompt or terminal, run the
liquibase init hub command with the token you see in the Liquibase Hub dialog and follow the CLI instructions depending on the database:
- To use the H2 database that is included with the Liquibase installation files, enter Y for the default settings.
- To use your database, enter C and customize the username, password, and database URL parameters. After running the command, check or add a database driver.
Note: The command will connect your local Liquibase activity to Liquibase Hub with an API key and set up the Liquibase environment. If you are new to Liquibase, the
init hub command will create configuration files for you. For more information, see the init hub command.
Tip: If you encounter any issues with a token or environment setup, configure Liquibase Hub manually. register-changelog and proceed with running commands. As an alternative, Liquibase provides an Liquibase Hub Auto-Registration and Report Links option when you run the
update command. If you are new to Liquibase, see Getting Started with Liquibase.
Deploy your first change
Navigate to the registered Liquibase project directory and run the following command:
Note: To use the in-memory H2 database, open a new terminal window and run the
liquibase init start-h2 command before running the
- Open your Liquibase Hub report to see the update details.
To learn the Liquibase Hub concepts, check the following pages:
To connect more files to Liquibase Hub: