Try It Out

This example runs Liquibase against a Minimus Postgres container on a shared Docker network.

Create a network and start Postgres:

docker network create liquibase-test

docker run -d --name liquibase-db --network liquibase-test \
  -e POSTGRES_PASSWORD=Minimus! \
  reg.mini.dev/postgres

Wait a few seconds for Postgres to accept connections.

Create a project directory and save the following as db.changelog-master.yaml:

databaseChangeLog:
  - changeSet:
      id: 1
      author: minimus
      changes:
        - createTable:
            tableName: greeting
            columns:
              - column:
                  name: id
                  type: int
                  autoIncrement: true
                  constraints:
                    primaryKey: true
              - column:
                  name: message
                  type: varchar(255)

Starting with Liquibase 5.0, database drivers are no longer bundled in the image. To run this setup, keep the following requirements in mind:

• Driver Installation - We must install the PostgreSQL driver via LPM and run the update command within the same container execution.
• Root Permissions - Because the image runs as non-root by default, the --user root flag is required. This allows the container to read the mounted changelog and gives LPM the permissions needed to install the driver.

docker run --rm \
  --user root \
  --network liquibase-test \
  -v "$PWD":/liquibase/changelog \
  -w /liquibase/changelog \
  --entrypoint sh \
  reg.mini.dev/liquibase \
  -c 'lpm add postgresql --global && liquibase \
    --url=jdbc:postgresql://liquibase-db:5432/postgres \
    --username=postgres \
    --password=Minimus! \
    --changeLogFile=db.changelog-master.yaml \
    update'

Liquibase applies any pending changesets and records them in the database changelog tables. For example:

Running Changeset: db.changelog-master.yaml::1::minimus

UPDATE SUMMARY
Run:                          1
Previously run:               0
Filtered out:                 0
-------------------------------
Total change sets:            1

Liquibase: Update has been successful. Rows affected: 0
Liquibase command 'update' was executed successfully.

Confirm the table was created:

docker exec -it liquibase-db psql -U postgres -c "\dt greeting"

You should see the greeting table listed.

Remove the Postgres container from Step 1 (liquibase-db) and the Docker network:

docker rm -f liquibase-db
docker network rm liquibase-test

Technical Considerations

The Liquibase image provided by Minimus is a slim, security-hardened alternative to the public image from Docker Hub. The images are largely interchangeable, with a few differences as noted below.

Terms & Info

This catalog is published by Minimus. All product names, logos, and marks, other than those belonging to Minimus, shown are owned by their respective rights holders and appear here only to identify the open source software each image contains. Minimus claims no ownership of those marks and implies no affiliation with, endorsement by, certification by, or sponsorship by any rights holder.

Images are provided "as-is" without warranty of any kind. "Hardened" refers to the security configuration applied at the time of build and does not constitute a guarantee of ongoing security or absence of vulnerabilities. The free tier is provided without support, SLA, or guaranteed patching timelines. Security updates may be applied to paid subscriptions before or instead of free tier images. By pulling or using any image you agree to our Terms of Use.