cfnrain is a command line tool for AWS CloudFormation templates and stacks. It deploys stacks through change sets, packages local files into templates, formats templates, and shows stack logs.
cfnrain is a community fork of AWS CloudFormation Rain. AWS archived Rain on 2026-07-29. cfnrain continues from Rain's last commit, and works as a replacement for Rain v1.24.4.
cfnrain is not affiliated with or endorsed by Amazon Web Services.
Read the documentation at awesome-foundation.github.io/cfnrain. It covers installation, a first deploy, every command, the template directives, modules, CI usage, and migrating from Rain.
Download an archive for your system from the releases page, and check it against checksums.txt and its build provenance:
sha256sum --ignore-missing -c checksums.txt
gh attestation verify <archive> -R awesome-foundation/cfnrainOr build it with Go:
go install github.com/awesome-foundation/cfnrain/cmd/cfnrain@latestComing from Rain? Link the old name, so your scripts keep working:
ln -s "$(command -v cfnrain)" /usr/local/bin/rainIn GitHub Actions, use install-cfnrain:
- uses: awesome-foundation/install-cfnrain@v1See Install and Migrating from rain for the details.
cfnrain is written in Go. To contribute, fork this repository, make your change, and open a pull request. Questions and ideas go to GitHub Discussions.
The documentation site is the Markdown in docs/. When you add or change a command or a flag, update the page in docs/ that describes it. A unit test fails when a command has no page. To build the site, install Zensical and run zensical build --clean --strict in the repository root.
cfnrain is licensed under the Apache 2.0 License. The NOTICE file keeps the original Rain copyright.