Sharing your GitHub App via an install link
-
Navigate to your account settings.
- For a GitHub App owned by a personal account, in the upper-right corner of any page, click your profile photo, then click Settings.
- For a GitHub App owned by an organization, in the upper-right corner of any page, click your profile photo, then click Your organizations. Then, to the right of the organization, click Settings.
-
In the left sidebar, click Developer settings.
-
In the left sidebar, click GitHub Apps.
-
Next to the GitHub App that you want to share, click Edit.
-
Click Public page. GitHub will bring you to the public page for your GitHub App.
-
Click Install. GitHub will bring you to the installation URL for your GitHub App. The URL will look something like
http(s)://HOSTNAME/github-apps/APP-NAME/installations/new
, whereAPP-NAME
is the name of the GitHub App. -
Share the installation URL with other users. For more information about how users can install your app from this URL, see "Installing a GitHub App from a third party."
When you share the URL, you can include a
state
query parameter in the installation URL to preserve the state of the application page and return people back to that state after they install, authenticate, or accept updates to your GitHub App. For example, you could use thestate
to correlate an installation to a user or account.To preserve a state, add it to the installation URL:
http(s)://HOSTNAME/github-apps/<app name>/installations/new?state=AB12t
Sharing your GitHub App with GitHub Enterprise Server instances
If you want to share your GitHub App with GitHub Enterprise Server instances that you are not part of, you need to take additional steps. For more information, see "Making your GitHub App available for GitHub Enterprise Server."