Skip to content
Logo Logo Finisterra

Quick Start

Finisterra generates Terraform code for your existing infrastructure by connecting to your cloud provider.

Finisterra Web

  • Visit https://app.finisterra.io.
  • Log in using your Google account.
  • Click on Add a new AWS account.
  • Install the GitHub App and grant it permissions to access a repository where the Terraform code will be stored.
  • Return to the Finisterra website and select the desired repository.
  • Click Next.
  • Enter an Account Name for identification purposes.
  • Choose the Region where your AWS resources are located.
  • In the Role ARN field, Finisterra uses OIDC to authorize GitHub to connect to AWS only from your github organization. If you do not have a role, click Create Role to initiate a CloudFormation stack that prepares the necessary role with read only permissions as default.. After the role is created, input its ARN into the Role ARN field.
  • Click Create.

Finisterra will then push workflows to your GitHub repository that invoke the Finisterra API to generate the code, automatically creating Pull Requests with the Terraform code.