integrations / integrations/terraform-provider-github

[FEAT]: Add support for installing GitHub Apps on all repositories in an organization

Open
#3,460 6 comments 8 reactions 0 assignees View on GitHub
Status: Blocked Type: Feature
Dominant language
Go
Stars
1.2k
Forks
1k
Avg merge
1d 14h
Merged PRs (30d)
8

Description

### Describe the need

## Summary

Please add a new resource to support installing GitHub Apps on organizations with access to all repositories.

## Use Case

My goal is to install a GitHub App on an organization and grant it access to all repositories (`repository_selection = "all"`).

The existing `github_app_installation_repositories` resource does not provide a way to grant a GitHub App access to all repositories in an organization.

While it is possible to add repositories individually using the repository installation APIs, those APIs do not support an equivalent of `repository_selection = "all"`. As a result, Terraform users must enumerate and manage every repository individually.

For organizations with thousands of repositories, this approach is not practical and does not accurately model the desired state of "install this app on all repositories."

GitHub provides a [separate API ](https://docs.github.com/en/enterprise-cloud@latest/rest/enterprise-admin/organization-installations?apiVersion=2022-11-28#install-a-github-app-on-an-enterprise-owned-organization) that supports organization-wide installations with `repository_selection = "all"` within an enterprise, but this functionality is not currently represented by a Terraform resource.

## Proposed Solution

Introduce a new resource that manages GitHub App installations and supports granting access to all repositories in an organization within an enterprise.

## References

- https://docs.github.com/en/enterprise-cloud@latest/rest/apps/installations?apiVersion=2026-03-10#add-a-repository-to-an-app-installation
- https://docs.github.com/en/enterprise-cloud/rest/enterprise-admin/organization-installations#install-a-github-app-on-an-enterprise-owned-organization

### GitHub Installation Type

- [ ] GitHub.com (Free, Pro, or Team)
- [ ] GitHub Enterprise Server (on-premises)
- [x] GitHub Enterprise Cloud with Personal Accounts (github.com)
- [x] GitHub Enterprise Cloud with Managed Users/EMU (github.com)
- [ ] GitHub Enterprise Cloud with Data Residency (*.ghe.com)
- [ ] I don't know

### Relevant log output

```shell

```

### Code of Conduct

- [x] I agree to follow this project's Code of Conduct

Contributor guide

Open the contributing guide

Assessment

This issue has not been assessed yet.

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.