Skip to main content
In this article, we explain how to specify provider versions in Terraform to ensure your configuration consistently uses the intended plugin version. By default, running the terraform init command downloads the latest provider plugins from the public Terraform Registry. This behavior, however, might lead to unexpected issues if newer provider versions introduce breaking changes. To prevent this, you can restrict provider versions using version constraints in your Terraform configuration. Consider the basic Terraform configuration below that creates a local file:
When you run:
you might see output similar to the following:
Always specify provider versions to ensure your Terraform configurations remain stable, especially if newer provider releases might introduce breaking changes.
Because provider functionalities can change drastically between versions, it is critical to use a specific version that you have thoroughly tested. Detailed instructions for each provider’s versioning are available on the provider’s Terraform Registry page. For instance, if the default and latest version of the local provider is 2.0.0 but your configuration requires an older version such as 1.4.0, update your configuration accordingly.

​
Specifying a Specific Provider Version

To enforce a particular version of the local provider (for example, version 1.4.0), include a terraform block with a required_providers sub-block. This block explicitly instructs Terraform which version to install. Consider the following configuration:
When you run terraform init, Terraform reads the configuration and installs version 1.4.0 of the local provider.

​
Using Comparison Operators for Version Constraints

Terraform supports several comparison operators to manage provider version constraints. For example, if you want to exclude a specific version, you can use the not-equal operator. In the configuration below, Terraform is directed to avoid version 2.0.0:
You can also combine comparison operators to define a version range. The following configuration tells Terraform to use any version greater than 1.2.0 but less than 2.0.0, explicitly excluding version 1.4.0:
In this setup, Terraform may choose version 1.3.0 if it is the highest acceptable version according to the defined constraints.

​
The Pessimistic Constraint Operator

Terraform offers the pessimistic constraint operator (~>) to allow patch-level flexibility while preventing major version upgrades. For example, using the following configuration:
Terraform can use version 1.2 and any incremental versions such as 1.3 or 1.4, up to but not including 2.0. If the maximum available version in the registry is 1.4.0, that version will be installed. If you want to tightly constrain the version (for example, only accepting versions from 1.2.0 up to 1.2.9), consider the following configuration:
In this configuration, Terraform will install version 1.2.2 if that is the highest version available within the defined range. After updating your configuration, running:
will produce output similar to this:
This output confirms that Terraform installed the specified version of the local provider.
For more best practices on managing Terraform configurations and version constraints, explore additional resources and updated documentation on the Terraform Registry and Terraform Documentation.
That concludes our article on Terraform version constraints. To further reinforce your understanding, experiment with these versioning techniques in your Terraform practice environment to ensure your configurations remain stable over time.

Watch Video

Practice Lab