Set Terraform Version

Specify a custom version for your Terraform or OpenTofu artifact.

Prerequisites

• Terraform/OpenTofu artifact with bricks.json

• Desired version (see version limits below)

Quick Start

Add the version field to your bricks.json:

For Terraform

{
  "name": "my-terraform-artifact",
  "version": "1.0.0",
  "native": {
    "type": "terraform",
    "path": "./src/terraform",
    "version": "1.5.7"
  }
}

For OpenTofu

{
  "name": "my-opentofu-artifact",
  "version": "1.0.0",
  "native": {
    "type": "opentofu",
    "path": "./src/terraform",
    "version": "1.9.0"
  }
}

Version Limits

Supported versions for each tool:

Tool	Min Version	Max Version	Default
Terraform	1.0.0	1.5.7	1.5.7
OpenTofu	1.0.0	Latest	1.8.7

Examples

Using Latest Terraform (1.5.7)

{
  "native": {
    "type": "terraform",
    "path": "./terraform",
    "version": "1.5.7"
  }
}

Using Latest OpenTofu

{
  "native": {
    "type": "opentofu",
    "path": "./terraform",
    "version": "1.9.0"
  }
}

Pinning to Specific Versions

{
  "native": {
    "type": "terraform",
    "path": "./terraform",
    "version": "1.4.6"
  }
}

{
  "native": {
    "type": "opentofu",
    "path": "./terraform",
    "version": "1.8.7"
  }
}

Verification

Test your version configuration:

bricks run . --dry --props-file properties.json

The plan output will show which version is being used.

See also

• Terraform vs OpenTofu -- licensing and engine comparison

• How to Publish a Terraform Module -- package and publish your Terraform code