Skip to main content

GitHub Integration

GitHub is connected to Amnify to provide access to your Terraform template repositories for the Deploy feature.

Prerequisites

  • A GitHub account with access to the repository containing your Terraform templates
  • A Personal Access Token (PAT) with repository read permissions

Connect GitHub

  1. Go to Configuration > Integrations
  2. Click “Add Integration” and select GitHub
  3. Enter your Personal Access Token
  4. Amnify validates the token and confirms repository access
Only one GitHub integration is allowed per organization.

What GitHub is used for

GitHub is not a security scanning provider. It serves as the source for Terraform templates and code used by the Deploy feature:
  • Template sync: Amnify discovers and syncs templates from your repository
  • Deployment source: When deploying infrastructure, Amnify fetches Terraform code from your GitHub repo
  • Version pinning: Each deployment is pinned to a specific commit SHA for reproducibility

How templates work

Amnify populates your GitHub repository with a curated library of Terraform templates. You own the repository and can:
  • Customize any template to fit your requirements
  • Add your own Terraform modules
  • Version templates through normal Git workflows
See Templates for more details on working with deployment templates.