---
title: "Map a Terraform root for an AWS or Google Cloud connection | Proofline Help"
description: "Choose the registered GitHub repository and root that should own the proposed connection files. Check the existing declarations before asking Proofline to prepare a change."
url: https://proofline.sh/help/terraform-root-mapping/
---

[Help center](/help/)

# Map a Terraform root for an AWS or Google Cloud connection

Choose the registered GitHub repository and root that should own the proposed connection files. Check the existing declarations before asking Proofline to prepare a change.

## Select the root and scope the variables

1.  Open **Settings → Connections → Terraform changes**.
2.  Start a new Terraform change.
3.  Select the repository and its Terraform root. The list leaves out directories that another Terraform directory uses as a local module. To use one of them as a root, choose **Enter a root path**.
4.  Choose the cloud provider and provider name or alias.
5.  Select the connections owned by that root.
6.  For an AWS connection, choose the **Terraform change**: **Add a Proofline IAM role**, **Set the variable of an existing role** when the root already declares one, or **Maintain the inventory grant on an existing role**.
7.  To set a variable, enter the variables file in the root, such as `terraform.tfvars`, and the variable name.
8.  To maintain the inventory grant, choose **Add a policy** or **Update a Terraform policy** under **Inventory policy**. To update one, enter its **Policy file** and **Policy resource label**. List every region the connection reads in **Inventory regions**.
9.  Save the entry and inspect the generated change.

**Prepare a Terraform pull request** on a GKE cluster's setup opens a new change with that cluster and its namespaces selected.

Organization administrators and people with the **Prepare Terraform changes** permission can prepare a change. You need read access on GitHub to every repository you select. Preparing a change writes nothing to GitHub.

Connect the relevant AWS or Google Cloud account first. An AWS connection can be chosen once its setup confirms the account. When no AWS connection can be chosen yet, New change links to the unconfirmed connection's setup. Choose the root that actually owns the connection's infrastructure.

To set a variable, the root must declare it and the file must not set it yet. Proofline appends the connection's values and keeps the rest of the file unchanged.

The inventory grant lets Proofline read the account's inventory in the listed regions without taking ownership of the role. If the inventory policy already exists, choose **Update a Terraform policy** to edit the resource that owns it, or import it through your pipeline first.

## Related guides

-   [Prepare Terraform changes](/help/terraform-changes/)
-   [Connect Amazon Web Services](/help/connect-aws/)
