README.md

Terraform Provider GitHub

This is a fork of the official Terraform GitHub provider maintained by @vmvarela, published under vmvarela/github with additional enterprise features pending upstream merge.

• Terraform Registry: registry.terraform.io/providers/vmvarela/github
• OpenTofu Registry: search.opentofu.org/provider/vmvarela/github
• Upstream: integrations/terraform-provider-github

Requirements

• Terraform 1.x or OpenTofu 1.x
• Go 1.26.x (to build the provider plugin)

Usage

terraform {
  required_providers {
    github = {
      source  = "vmvarela/github"
      version = "~> 26.0"
    }
  }
}

Full provider documentation is available on the Terraform Registry.

Additional Features (vs upstream)

This fork includes the following features that are open PRs against upstream:

• Enterprise Billing Usage — github_enterprise_billing_usage data source
• Enterprise Cost Centers — github_enterprise_cost_center resource and data sources
• Enterprise SCIM — github_enterprise_scim_* resources for user and group provisioning
• Enterprise Teams — enhanced enterprise team management resources

Contributing

Detailed documentation for contributing to this provider can be found in CONTRIBUTING.md.

For release and publishing instructions, see RELEASE.md.

Roadmap

This project uses Milestones to track upcoming features and fixes.

Support

This is a community-maintained fork. For issues specific to the additional enterprise features, open an issue in this repository. For upstream provider issues, refer to the integrations/terraform-provider-github project.