RunsOn RunsOn

RunsOn is finally on Terraform/OpenTofu

RunsOn now supports Terraform and OpenTofu starting with v2.11.0, alongside the existing CloudFormation deployment path.

RunsOn is finally on Terraform/OpenTofu

One of the most requested features since RunsOn launched has been Terraform support. Of course, if your team already manages everything in Terraform, deploying a CloudFormation stack alongside it feels wrong.

We get it.

So after a few months of development and extensive testing, it’s here. Starting with v2.11.0, you can deploy RunsOn using Terraform or OpenTofu.

(If you’re curious why CloudFormation was the default in the first place, and why it still is, I wrote about that here.)

How it works

Two design decisions guided the module:

Bring your own VPC. If you’re reaching for Terraform, you almost certainly already have networking set up. The module plugs into your existing VPC rather than creating its own. If you don’t have one, we provide an example to create and plug in the official AWS VPC module.

Smart defaults, full override. Minimal configuration to get running, but everything is exposed if you want to customise it. HCL’s flexibility actually enables configuration combinations and validations that CloudFormation’s primitives can’t easily support.

What this means for CloudFormation

Both deployment options are here to stay, but they’re going to diverge in purpose.

CloudFormation is becoming simpler. Over the next few months we’re reducing parameters and streamlining the template to focus on what CF does best: getting RunsOn up and running in a few clicks.

Terraform is becoming more powerful. Fine-grained control, deep infrastructure integration, full customisation.

CloudFormation for fast starts and smart defaults for 80% of the users. Terraform for the rest who want full control over everything.

A heads-up for existing CF users with heavily customised parameters: as we simplify the CloudFormation template, some advanced configuration options will move to Terraform only. We’ll share the details and migration path in a dedicated post before anything changes.

Get started

The module is live on the Terraform Registry. You can also follow the Terraform / OpenTofu guide for setup details and examples. Give it a spin and let us know how it goes.