# Liquibase Workertools

Liquibase Workertools is a ready-to-run Docker image that packages Liquibase, the open-source tool for versioning and deploying database schema changes, as an Octopus Deploy worker. It is open source and self-hosted, installable on Docker Hub.

Canonical page: https://ourlocalhost.com/app/6132/liquibase-workertools

## Description

Liquibase Workertools is a ready-to-run Docker image that packages Liquibase, the open-source tool for versioning and deploying database schema changes, as an Octopus Deploy worker. It bundles everything needed to run Liquibase reliably so teams can apply and automate their database schema changes without manually setting up the tool on their own servers.

## Platform availability

Available on 0 of 10 platforms.

## Health score

76/100 (Good), based on 4 of 4 factors.
- Maintained: 100 (last commit 25 days ago)
- Popular: 75 (5,637 GitHub stars)
- Easy to install: 25 (0 install platforms, install notes, Docker image)
- Light to run: 80 (1 GB minimum RAM, runs on ARM)

## Links

- Docker Hub: https://hub.docker.com/r/octopuslabs/liquibase-workertools
- Official website: https://www.liquibase.org
- GitHub: https://github.com/liquibase/liquibase

## Common questions

### Why does my self-hosted Liquibase container fail to connect to a database?

Liquibase 5 does not include most database drivers by default. Add the matching driver, for example by setting INSTALL_MYSQL=true for MySQL or using lpm add mysql in a Dockerfile.

### Why are some changelog folders ignored by my self-hosted Liquibase run?

Set LIQUIBASE_SEARCH_PATH to list every changelog folder that should be used, including the current folder if needed, because the current folder is not included automatically.

### Where should I look if a Liquibase change set does not roll back correctly?

The Liquibase troubleshooting section includes guidance for rollback issues.

### Is SQLPlus authentication failure covered when Liquibase is configured with runWith: sqlplus?

Yes, the Liquibase troubleshooting section lists SQLPlus failing with ORA-01017 when using runWith: sqlplus.

---
Source: Our Local Host (https://ourlocalhost.com/app/6132/liquibase-workertools), the self-hosted and open-source app directory.
