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.