---
title: "Resolve missing AWS installer permissions | Proofline Help"
description: "If the deployment identity cannot create the Proofline role, check its IAM and CloudFormation permissions before retrying the installation."
url: https://proofline.sh/help/aws-installer-permissions/
---

[Help center](/help/)

# Resolve missing AWS installer permissions

If the deployment identity cannot create the Proofline role, check its IAM and CloudFormation permissions before retrying the installation.

## Check the installer and the service role

The person or pipeline installing the role needs IAM write permissions. Proofline's runtime read permissions do not authorize installation. The installer needs `iam:CreateRole` and `iam:PutRolePolicy` on the exact supplied role name. Managing the role also requires `iam:GetRole`, `iam:UpdateAssumeRolePolicy`, and the deployment tool's read, update and deletion operations.

For Terraform and Pulumi, role management can require `iam:ListRolePolicies`, `iam:GetRolePolicy`, `iam:ListAttachedRolePolicies`, `iam:ListInstanceProfilesForRole`, `iam:ListRoleTags`, `iam:UpdateRole`, `iam:UpdateRoleDescription`, `iam:DeleteRolePolicy`, and `iam:DeleteRole`. Tagging needs `iam:TagRole` and `iam:UntagRole`. Managing a boundary needs `iam:PutRolePermissionsBoundary` and `iam:DeleteRolePermissionsBoundary`. Have your AWS administrator scope these permissions to the supplied role and your approved policies.

CloudFormation also needs `cloudformation:CreateStack`, `cloudformation:DescribeStacks`, and `cloudformation:DescribeStackEvents`. Its IAM capability acknowledgement grants no permissions. By default, CloudFormation uses the caller’s permissions. You can select an approved CloudFormation service role in AWS’s **Permissions** section. The caller needs `iam:PassRole` for that role, and the service role needs permission to manage the Proofline role. The console uses `iam:ListRoles` to populate the selector; if listing is denied, enter the approved role ARN manually. Rollback needs permission to delete the role and its inline policy.

If your deployment identity is restricted to application role names or requires a permissions boundary, ask your AWS administrator to authorize the Proofline role. Changing tools does not bypass IAM restrictions. Keep the supplied role name; renaming it to fit an application's prefix breaks this connection.

## Related guides

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