Skip to content

Getting Started

Step 2

GitHub Actions Workflow

Click here for the Terrateam GitHub Actions workflow file

The Terrateam GitHub workflow file must be stored in the default branch of your Terraform repository. The default branch is usually named main or master.

Expand for detailed workflow file setup instructions
  1. Create a new branch in your repository
git checkout -b terrateam-setup
  1. Create a .github/workflows directory
mkdir -p .github/workflows
  1. Store the Terrateam GitHub Actions workflow file in the .github/workflows directory
curl -L -o .github/workflows/terrateam.yml \
  1. Commit and push .github/workflows/ to your branch
git add .github/workflows/ && \
git commit .github/workflows/ -m "Terrateam GitHub Actions workflow file" && \
git push --set-upstream origin terrateam-setup
  1. Create a pull request to merge your changes into the default branch
gh pr create --fill
  1. Merge your new pull request

Step 3

Cloud Provider Setup

Terrateam needs permission to access your cloud provider in order to make changes with the Terraform CLI.

Next Steps

Pull Request

Create a Pull Request with a Terraform code change
  1. Terrateam will automatically run terraform plan and comment back the output

  2. Comment on the pull request with terrateam apply to apply changes

  3. Merge the pull request


Learn how to fully customize your workflow with our runtime configuration file.


Join our Slack community or email support if you need help on-boarding.