Using Locally with the OpenTofu AzureRM Provider

Provisioning a Resource Group

In this example we're going to provision a Resource Group within the First Subscription. We first need to define a provider block for the opentofu/azurerm provider in a file named main.tf:

provider "azurerm" {
  features {}
}

Next we need to add the OpenTofu resource to provision a Resource Group - in this case with the name rg-from-tofu in the location berlin:

provider "azurerm" {
  features {}
}

resource "azurerm_resource_group" "example" {
  name     = "rg-from-tofu"
  location = "berlin"
}

Now that we've created our OpenTofu configuration, we need to download the opentofu/azurerm provider by running:

If Locally isn't already running, we'll need to start it by running:

At which point we can deploy this OpenTofu configuration against Locally by running:

Once that's applied, if we open the First Subscription within the Locally Dashboard, and view the Resource Groups then we should see our newly created Resource Group.

Next steps

If you have an existing OpenTofu configuration that already targets Azure and you'd like to point it at Locally, see the Existing AzureRM Configuration guide. To run tofu apply against Locally in your pipeline, see Using Locally in CI.

Should you encounter any issues, please take a look at the troubleshooting section.

You can find more examples of how to use OpenTofu with Locally in the Examples in the Documentation.