A step-by-step guide for migrating from Terraform to OpenTofu, covering the reasons to migrate (licensing change, new features like state encryption and early variable evaluation), common challenges (registry references, CI/CD pipeline updates, version matching), a pre-migration checklist, the actual migration steps, and a rollback strategy. Since both tools share HCL, the same provider ecosystem, and state file format, migration is largely a binary swap for most teams on Terraform 1.5x or earlier.

11m read timeFrom spacelift.io
Post cover image
Table of contents
Why migrate to OpenTofu?What are the challenges when migrating from Terraform to OpenTofu?Pre-migration checklistTerraform to OpenTofu migration guideHow to roll back to TerraformHow can Spacelift help you with OpenTofu and Terraform projectsKey points

Sort: