Resolving "Nomad Address Must Be Set" Error in Terraform Enterprise

Problem

When installing Terraform Enterprise on a Nomad Enterprise cluster, the installation may fail with the following error message in the logs.

[ERROR] terraform-enterprise: check failed: name=config duration="42.294µs" err="nomad address must be set","component":"terraform-enterprise"

This error indicates that Terraform Enterprise cannot correctly configure its integration with the Nomad Enterprise cluster.

Cause

This error is caused by a version incompatibility between Terraform Enterprise and Nomad Enterprise.

• Terraform Enterprise versions prior to v202408-1 contain a known issue that prevents successful integration with Nomad Enterprise.
• This issue affects environments where the Nomad Enterprise version is older than 1.5.0+ent.

The fix for this incompatibility was introduced in Terraform Enterprise version v202408-1.

Solution

To resolve this error, you must ensure that both Terraform Enterprise and Nomad Enterprise are running compatible versions.

Solution 1: Upgrade Terraform Enterprise and Nomad Enterprise

1. Upgrade your Terraform Enterprise instance to version v202408-1 or a later version.
2. Ensure your Nomad Enterprise cluster is running version 1.5.0+ent or a later version.

Updating both products to these minimum versions resolves the communication issue and allows for a successful integration.

Outcome

After upgrading both Terraform Enterprise and Nomad Enterprise, the nomad address must be set error should no longer appear in the logs. You can validate the fix by deploying a run in Terraform Enterprise to confirm it can communicate successfully with the Nomad cluster.

Additional Information

• For guidance on upgrading, please refer to the official Terraform Enterprise upgrade documentation.
• For more details on Nomad versions, consult the official Nomad Enterprise documentation.