• Task
  • Version · 5.2
  • User guide

Use the checks settings file

Last updated: October 22, 2026

You can run the policy checks that are enabled in your settings file by using the checks run command.

Tips for using your settings file

  • To use the in-memory file while running run or show, enter N at runtime. Other commands require a checks settings file to save the changes for checks.

  • To use a checks settings file customized for a specific environment or project, specify the name with the --checks-settings-file parameter. If you do not specify this parameter, Liquibase uses the in-memory file or default settings file: liquibase.checks-settings.conf.

  • To group multiple checks settings files together and run them in a single run or show command, create a checks package.

Procedure

1

Run this command against your checks settings file

liquibase checks run --checks-settings-file=<my_file_name>.yaml --changelogfile --<your_changelog_here>.sql

If your liquibase.checks-settings.conf file is from an earlier version of Liquibase Secure, it is automatically upgraded when you run a checks command. Liquibase creates a single backup file per upgrade run and displays a message identifying the version the file was upgraded from and to, for example: "The checks settings file has been upgraded from version 1.1 to version 2.0". The follow-up prompt accurately states whether a backup will be created.

PreviousCreate an additional checks settings fileNextSeverity and exit codes in Policy check automation