Flyway 12.8.1 Release Overview

Flyway 12.8.1, released on 2026-06-05, provides important fixes for users of the database migration tool. This patch primarily addresses issues related to configuration overrides, enhancing flexibility for dynamic environments.

TL;DR

  • Critical fix for system/environment variable property overrides.
  • Improved configuration flexibility for Flyway Pro/Enterprise editions.
  • Enhances reliability for CI/CD pipeline integration.

Key Changes

The primary change in Flyway 12.8.1 addresses a critical issue where numerous configuration properties could not be overridden by system properties or environment variables. This affected a wide spectrum of settings crucial for flexible deployment and automation. Specifically, properties related to migration locations (flyway.locations), schema management (flyway.schemas, flyway.createSchemas, flyway.defaultSchema), connection details (flyway.url, flyway.user, flyway.password, flyway.driver, flyway.jdbcProperties, flyway.connectRetries), and migration behavior (flyway.outOfOrder, flyway.target, flyway.cleanDisabled, flyway.baselineOnMigrate, flyway.validateOnMigrate, flyway.failOnFutureMigrations, flyway.skipExecutingMigrations, flyway.skipValidation) were impacted.

Furthermore, properties controlling placeholders (flyway.placeholderReplacement, flyway.placeholders), SQL migration naming conventions (flyway.sqlMigrationPrefix, flyway.sqlMigrationSuffixes), and custom extensions (flyway.callbacks, flyway.resolvers, flyway.resourceProvider, flyway.errorHandlerProvider) also experienced this override problem. This extensive fix restores the expected configuration behavior, which is particularly important for dynamic environments and CI/CD pipelines where external configuration is a standard practice for managing different stages (development, testing, production). This update applies to Pro/Enterprise editions, ensuring greater flexibility and control over database migration processes and consistent application across diverse operational contexts.

For a complete list of all fixed properties, refer to the official release notes.

Impact for QA Teams

For QA teams, this update significantly improves the reliability and flexibility of test environment setup. Teams relying on dynamic environment configurations via system properties or environment variables for database connection strings, schema names, or migration paths will find their setup more predictable and stable. This ensures consistent database state management across different test environments, from local development to staging, reducing configuration-related failures during migration testing. It also simplifies the integration of Flyway into CI/CD pipelines, allowing QA to validate database changes more efficiently and with fewer manual adjustments per environment. This leads to more robust and repeatable testing cycles.