Redgate Summit – The Database DevOps Transformation Watch now
PASS Data Community Summit logo

PASS Data Community Summit

A hybrid conference in Seattle and online

15-18 November

Flyway Documentation

This documentation site is not updated. The new documentation can now be found on



In order to log in to your database, the typical approach is to set your username and password in the Flyway configuration file. This however has some concerns:

  • These properties are stored in plain text - anyone can see your credentials
  • Your credentials must be supplied in every configuration file you use
  • You may not have access to these credentials, and someone else needs to configure them securely

Flyway comes with additional authentication mechanisms that tackle these concerns.

Environment Variables

By storing your username and password in the environment variables FLYWAY_USER and FLYWAY_PASSWORD respectively, they can be configured once and used across multiple Flyway configurations. They can also be set by someone who has the relevant access, so they do not end up being leaked to any unwarranted parties.

Database Specific Authentication


SQL Server and Azure Synapse




Platform Specific Authentication


Configure the JDBC URL to point to an AWS RDS instance: flyway.url=jdbc:mysql://<RDS_INSTANCE_HOSTNAME>:<RDS_INSTANCE_PORT>

Set flyway.user to be the database user and flyway.password to be the IAM authentication token: flyway.password=<AuthToken>

You can read more about AWS IAM in Java applications here.

AWS Secrets Manager