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:
| Constraint | Meaning |
|---|---|
"~> 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:
- Download the provider binary from the GitHub releases page.
- Place it in the local filesystem mirror directory.
- Configure a
filesystem_mirrorin 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.