State Management

OpenTaco State Management helps you create and manage Terraform/OpenTofu state backends centrally, so your team can use consistent backend configuration, shared access controls, and state history across environments.

OpenTaco state management implements an interface compatible with HCP Terraform, so this can be used as a drop-in replacement workflow for tofu login and cloud block usage.

Prerequisite: Set up your OpenTaco account.

---

1. Create first unit

   In OpenTaco, a unit is a single managed state backend (workspace) for one root module/environment combination.

   Create your first unit from the UI, give it a name, and click create.

2. Configure cloud block

   Start with a minimal root module to verify state management end to end before wiring your full infrastructure code.

   Create main.tf:

   Your cloud block should follow this structure (replace placeholders with your real values from the unit details page):

   terraform {
     required_version = "~> 1.10.0"
   
     cloud {
       hostname     = "otaco.app"
       organization = "<your-org-id>"
   
       workspaces {
         name = "<your-unit-id>"
       }
     }
   }
   
   resource "null_resource" "smoke_test" {}
   
3. Authenticate with Opentofu

   Using the cli you can run the following command to authenticate:

   tofu login otaco.app
   

   You will have to confirm and will then be redirected to a token generation page. This page will allow you to generate a token and you can copy paste it back into the cli. You should see a message saying

   Success! Logged in to Terraform Enterprise (otaco.app)
   
4. try to run plan and apply

   Using Terraform or OpenTofu, run init, plan, and apply. It should succeed. If this is the case then well done! You have successfully created your first unit

Next steps

1. If you want to use remote execution, continue with Remote Runs (Beta).
2. Otherwise, continue with PR Automation onboarding.