Skip to main content

Using the Terraform Registry

The NetActuate Terraform provider is published on the Terraform Registry, which is the recommended installation method.

Installing from the Registry

Add the provider to your required_providers block:

terraform {
required_providers {
netactuate = {
source = "netactuate/netactuate"
version = "~> 1.0"
}
}
}

Then initialize your Terraform working directory:

terraform init

Terraform automatically downloads the provider from the registry during initialization.

Version Constraints

Use version constraints to control which provider version Terraform installs:

ConstraintMeaning
"~> 1.0"Any 1.x version (recommended)
">= 1.0, < 2.0"Same as above, explicit range
"= 1.2.3"Exact version only
">= 1.1"Version 1.1 or newer

Note: Pin to a minor version range (~> 1.0) for production use. This allows patch updates while preventing unexpected breaking changes.

Upgrading the Provider

To upgrade to a newer version within your constraint:

terraform init -upgrade

To change the version constraint, update the version field in your configuration and run terraform init -upgrade.

Verifying Installation

After running terraform init, verify the provider is installed:

terraform providers

This displays the installed providers and their versions.

Offline or Air-Gapped Environments

If your environment cannot access the Terraform Registry, you can:

  1. Download the provider binary from the GitHub releases page.
  2. Place it in the local filesystem mirror directory.
  3. Configure a filesystem_mirror in your Terraform CLI configuration.

See the Terraform documentation on provider installation for details.

Need Help?

If you need assistance with the Terraform provider, visit our support page.