# Versioning and Releases

> Terraform provider versioning model and upgrade guidance.

Source: https://docs.atensecurity.com/docs/terraform-provider/versioning-and-releases

The Thoth Terraform provider follows semantic versioning.

## Choose a release

The trial settings guide validates the `0.1.16` provider line. Check the
provider registry and release notes for available releases before upgrading;
SDK and provider versions are independent.

## Recommended version constraints

Pin to the minor line to receive patch updates:

```hcl
required_providers {
  thoth = {
    source  = "atensecurity/thoth"
    version = "~> 0.1.16"
  }
}
```

## Upgrade process

1. Review provider release notes in GitHub Releases and the Terraform Registry.
2. Run `terraform init -upgrade`.
3. Validate plan output in non-production environments.
4. Promote to production after approval.

## Release publication

Provider binaries are released from the public provider repository and published
to Terraform Registry using signed release artifacts.