This version of GitHub Enterprise was discontinued on 2022-10-12. No patch releases will be made, even for critical security issues. For better performance, improved security, and new features, upgrade to the latest version of GitHub Enterprise. For help with the upgrade, contact GitHub Enterprise support.
Building GitHub Apps
Creating a GitHub App
You can create and register a GitHub App under your personal account or under any organization you have administrative access to.
Setting permissions for GitHub Apps
When you create a GitHub App, you set the permissions that define the resources the app can access via the REST API.
Authenticating with GitHub Apps
You can authenticate as a GitHub App or as an installation.
Identifying and authorizing users for GitHub Apps
Your GitHub App can perform actions on behalf of a user, like creating an issue, creating a deployment, and using other supported endpoints.
Rate limits for GitHub Apps
Rate limits for GitHub Apps and OAuth Apps help control the rate of traffic to your GitHub Enterprise Server instance.
Refreshing user-to-server access tokens
To enforce regular token rotation and reduce the impact of a compromised token, you can configure your GitHub App to use expiring user access tokens.
Creating a GitHub App from a manifest
A GitHub App Manifest is a preconfigured GitHub App you can share with anyone who wants to use your app in their personal repositories. The manifest flow allows someone to quickly create, install, and start extending a GitHub App without needing to register the app or connect the registration to the hosted app code.
Creating a GitHub App using URL parameters
You can preselect the settings of a new GitHub App using URL query parameters to quickly set up the new GitHub App's configuration.
Creating a custom badge for your GitHub App
You can replace the default badge on your GitHub App by uploading your own logo image and customizing the background.