A Terraform module to deploy a responsive maintenance page using Cloudflare Workers with IP and path whitelisting.
Terraform-Cloudflare-Maintenance is a Terraform module that creates and deploys a responsive maintenance page using Cloudflare Workers. It solves the problem of displaying a professional maintenance page to users during site updates or outages, while allowing whitelisted traffic to access the site normally. The module fully automates the deployment through infrastructure-as-code, eliminating manual Cloudflare configuration.
DevOps engineers, SREs, and infrastructure teams managing websites on Cloudflare who need a programmatic way to handle maintenance windows. It's especially useful for teams already using Terraform for infrastructure management.
Developers choose this module because it provides a complete, automated solution for maintenance pages using familiar Terraform workflows. Unlike manual Cloudflare configurations, it offers version control, repeatable deployments, and easy toggling of maintenance mode through infrastructure-as-code.
Terraform module to create a responsive Maintenance Page using Cloudflare Workers.
Open-Awesome is built by the community, for the community. Submit a project, suggest an awesome list, or help improve the catalog on GitHub.
Seamlessly deploys and manages Cloudflare Workers through Terraform, as shown in the usage examples that automate route and script creation, eliminating manual dashboard configuration.
Supports custom logos, fonts, images, and HTML content via inputs like logo_url and info_html, allowing teams to match brand identity without editing the Worker code directly.
Enables IP and path whitelisting to bypass the maintenance page, ensuring administrators and critical services remain accessible during outages, as detailed in the whitelist_ips and whitelist_path variables.
Integrates directly into Terraform-managed environments, with an enabled flag for quick toggling and version-controlled deployments, reducing human error in maintenance operations.
Exclusively designed for Cloudflare Workers, making it non-portable to other CDN or hosting platforms, which limits flexibility if you switch providers.
Requires Cloudflare API credentials and Terraform expertise, adding complexity for teams not already using these tools, as seen in the need to export TF_VAR environment variables.
The maintenance page relies on static HTML and external URLs for assets; it lacks built-in support for dynamic updates or multi-language content beyond the basic status page link.