Skip to content

Terraform / OpenTofu

Deploy RunsOn using the official Terraform module

RunsOn provides an official Terraform module for deploying and managing your RunsOn infrastructure as code.

Official Terraform Module

The module is available on both registries:

The recommended approach is to use the official RunsOn Terraform module:

module "runs-on" {
  source  = "runs-on/runs-on/aws"
  version = "v2.11.0"

  github_organization = "my-org"
  license_key         = "your-license-key"
  email               = "alerts@example.com"

  vpc_id            = "vpc-xxxxxxxx"
  public_subnet_ids = ["subnet-pub1", "subnet-pub2", "subnet-pub3"]
}

For full documentation, available variables, and examples, see the official module on GitHub ↗.

The Terraform module should be used in the following cases:

Your organization already uses terraform to manage your AWS infrastructure, and you want to use the same tool to manage your RunsOn stack.
You want full control over how the networking stack is configured, and/or want to re-use an existing VPC.