• HashiCorp Developer

  • HashiCorp Cloud Platform
  • Terraform
  • Packer
  • Consul
  • Vault
  • Boundary
  • Nomad
  • Waypoint
  • Vagrant
Terraform
  • Install
  • Tutorials
    • About the Docs
    • Configuration Language
    • Terraform CLI
    • Terraform Cloud
    • Terraform Enterprise
    • CDK for Terraform
    • Provider Use
    • Plugin Development
    • Registry Publishing
    • Integration Program
  • Registry(opens in new tab)
  • Try Cloud(opens in new tab)
  • Sign up
Terraform Cloud

Cloud Docs Agents

Skip to main content
  • Cloud Docs Agents
  • Requirements
  • Install and Run Agents
  • Inject Custom Run Actions (Hooks)
  • Manage Agent Pools
  • Logging
  • Telemetry
  • Changelog

  • Resources

  • Tutorial Library
  • Certifications
  • Community Forum
    (opens in new tab)
  • Support
    (opens in new tab)
  • GitHub
    (opens in new tab)
  • Terraform Registry
    (opens in new tab)
  1. Developer
  2. Terraform
  3. Terraform Cloud
  4. Cloud Docs Agents
  5. Requirements
  • Terraform Cloud Agents
  • v1.5.x
  • v1.4.x
  • v1.3.x
  • v1.2.x

ยปRequirements

Important: All agents in an agent pool should have the same operating system and hardware resources available. If the agents are using different resources, run performance can vary significantly between each agent in the pool.

Ensure your system meets the following requirements before installing and configuring Terraform Cloud Agents. Refer to Terraform Cloud Agents on TFE for additional Terraform Enterprise requirements.

Supported Operating Systems

Agents currently only support x86_64 bit Linux operating systems. You can also run the agent within Docker using our official Terraform Cloud Agent Docker container.

Supported Terraform Versions

Agents support Terraform versions 0.12 and above. Workspaces configured to use Terraform versions below 0.12 cannot select the agent-based execution mode.

Hardware Requirements

The host running the agent has varying resource requirements depending on the workspace. A host can be a dedicated or shared cloud instance, virtual machine, bare metal server, or a container. You should monitor and adjust memory, CPU, and disk space based on each workspace's usage and performance. The name of your instance type may vary depending on your deployment environment.

Use the following specifications as a reference:

  • At least 4GB of free disk space
    • Each run requires the agent to temporarily store local copies of the tarred repository, extracted repository, state file, any providers or modules, and the Terraform binary itself.
  • At least 2GB of system memory

Networking Requirements

In order for an agent to function properly, it must be able to make outbound requests over HTTPS (TCP port 443) to the Terraform Cloud application APIs. These requests may require perimeter networking as well as container host networking changes, depending on your environment. Refer to the Terraform Cloud IP Ranges documentation for more details on the IP ranges.

Additionally, the agent must also be able to communicate with any services required by the Terraform code it is executing. This includes the Terraform releases distribution service, releases.hashicorp.com (supported by Fastly), as well as any provider APIs. The following services run on these IP ranges:

HostnamePort/ProtocolDirectionalityPurpose
app.terraform.iotcp/443, HTTPSOutboundPolling for new workloads, providing status updates, and downloading private modules from Terraform Cloud's Private Module Registry
registry.terraform.iotcp/443, HTTPSOutboundDownloading public modules from the Terraform Registry
releases.hashicorp.comtcp/443, HTTPSOutboundUpdating agent components and downloading Terraform binaries
archivist.terraform.iotcp/443, HTTPSOutboundBlob Storage
Edit this page on GitHub

On this page

  1. Requirements
  2. Supported Operating Systems
  3. Supported Terraform Versions
  4. Hardware Requirements
  5. Networking Requirements
Give Feedback(opens in new tab)
  • Certifications
  • System Status
  • Terms of Use
  • Security
  • Privacy
  • Trademark Policy
  • Trade Controls
  • Give Feedback(opens in new tab)