Create a Liquibase Project

Last updated: July 14, 2025

When you’re ready to use Liquibase, the first step whether you have an existing database or are implementing Liquibase while choosing a new database is to create a project. This guide shows you how to create a new Liquibase project using the init project command.

This guide shows you how to create a new Liquibase project using the init project command.

Liquibase projects are separate from your Liquibase installation. While the Liquibase CLI is installed globally on your system, the project directory is where all change tracking, environment configuration, and automation settings live.

Before you begin

Before you can run Liquibase commands, make sure it’s installed and accessible from your terminal.

To verify:

liquibase --version

If the command runs successfully and shows a version number, you’re ready to continue. If not, you may need to add Liquibase to your PATH. See Installing Liquibase for setup instructions using your preferred package manager or platform.

Procedure

1

Run the init project command

Navigate to the folder where you want your Liquibase project to live. Then run:

liquibase init project

Liquibase will prompt you:

Setup new liquibase.properties, flowfile, and sample changelog?
Enter (Y)es with defaults, yes with (C)ustomization, or (N)o. [Y]:

  • Press Y to accept default names and settings.

  • Press C if you want to customize the filenames or locations.

  • Press N to cancel.

2

Validate that your project creation was successful.

Liquibase generates several files in your current directory. You should see several files that have been created, including:

.
├── example-changelog.sql
├── liquibase.properties
├── liquibase.flowfile.yaml
├── liquibase.advanced.flowfile.yaml
├── liquibase.checks-package.yaml
├── liquibase.flowvariables.yaml
├── liquibase.endstage.flow

For most databases, you will now need to use the liquibase.properties file to connect your database to Liquibase.

We recommend you open this file now:

  • To prepare for connecting your database

  • To get familiar with how long-lived Liquibase properties are typically set (such as url, username, password, and changeLogFile)

This file allows you to avoid repeating common flags on every CLI command and is the standard approach in most Liquibase workflows.