> ## Documentation Index
> Fetch the complete documentation index at: https://openops-f559c8bf.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# OpenOpsApp AWS Role Stack

> How to set up the OpenOpssApp on AWS CloudFormation

The OpenOpsApp role stack for [AWS CloudFormation](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/Welcome.html) is used to create the `OpenOpsApp` role in your AWS account. This will in turn provide the OpenOps platform with the necessary permissions to connect to your AWS resources.

When creating the stack, you have the option to enable or disable certain permission sets. While the read-only permission set is mandatory, the rest are completely optional. The sets can also be enabled or disabled later by updating the stack.

## Installation

1. Navigate to CloudFormation on your AWS account, in the North Virginia (`us-east-1`) region. You can do so [by clicking here](https://us-east-1.console.aws.amazon.com/cloudformation/home?region=us-east-1). The stack **must** be created in the `us-east-1` region.
2. Click **Create stack**, then select **With new resources**:

   ![Creating a new stack](https://mintcdn.com/openops-f559c8bf/jHP4JOF17NoTQvTt/images/cloud-cf-roles-create-stack.png?fit=max\&auto=format\&n=jHP4JOF17NoTQvTt\&q=85\&s=ed135e1efcb633b618c7a31d84feaba7)
3. Under **Amazon S3 URL**, insert the following URL: `https://openops.s3.us-east-2.amazonaws.com/OpenOpsAppRoleStack.yml`, then click **Next**.

   ![Specifying a template](https://mintcdn.com/openops-f559c8bf/jHP4JOF17NoTQvTt/images/cloud-cf-roles-template.png?fit=max\&auto=format\&n=jHP4JOF17NoTQvTt\&q=85\&s=9f1e6ef58cea06c01e7f411aae7d12fa)
4. Give a name to the stack, such as `OpenOpsApp`. Enter the AWS account ID that was provided to you by OpenOps. This is the AWS Account ID that the OpenOps platform will use to access your account. Modify the permission sets if you like, then click **Next**.
5. Acknowledge the creation of the necessary IAM roles, then click **Next**:

   ![Capabilities](https://mintcdn.com/openops-f559c8bf/jHP4JOF17NoTQvTt/images/cloud-cf-roles-capabilities.png?fit=max\&auto=format\&n=jHP4JOF17NoTQvTt\&q=85\&s=160a7bc0a9d1a2ccf79bf13b08f78d94)
6. Click **Submit**. The stack will be created, including the `OpenOpsApp` role and the requested permissions.

## Modification

You’re welcome to [download the stack](https://openops.s3.us-east-2.amazonaws.com/OpenOpsAppRoleStack.yml) and modify specific permissions according to your needs. Notice that some AWS components in the OpenOps workflows may not function properly as a result.

## Support

With any questions or issues, please feel free to contact us via Slack or [email](mailto:support@openops.com).


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.