|
| 1 | +--- |
| 2 | +title: Sharing your GitHub App |
| 3 | +intro: 'You can share your {% data variables.product.prodname_github_app %} with other users.' |
| 4 | +versions: |
| 5 | + fpt: '*' |
| 6 | + ghec: '*' |
| 7 | + ghae: '*' |
| 8 | + ghes: '*' |
| 9 | +shortTitle: Share your app |
| 10 | +--- |
| 11 | + |
| 12 | +{% ifversion fpt or ghec %} |
| 13 | + |
| 14 | +### Sharing your {% data variables.product.prodname_github_app %} on {% data variables.product.prodname_marketplace %} |
| 15 | + |
| 16 | +If your {% data variables.product.prodname_github_app %} is public, you can choose to publish it to {% data variables.product.prodname_marketplace %}. For more information, see "[AUTOTITLE](/apps/publishing-apps-to-github-marketplace/github-marketplace-overview/about-github-marketplace)." |
| 17 | + |
| 18 | +{% ifversion ghec %}If you are an {% data variables.product.prodname_emu %}, then you cannot share your app on {% data variables.product.prodname_marketplace %}.{% endif %} |
| 19 | + |
| 20 | +For more information about how users can install your app from {% data variables.product.prodname_marketplace %}, see "[AUTOTITLE](/apps/using-github-apps/installing-a-github-app-from-github-marketplace-for-your-organizations)" and "[AUTOTITLE](/apps/using-github-apps/installing-a-github-app-from-github-marketplace-for-your-personal-account)." |
| 21 | + |
| 22 | +{% endif %} |
| 23 | + |
| 24 | +### Sharing your {% data variables.product.prodname_github_app %} via an install link |
| 25 | + |
| 26 | +{% ifversion fpt or ghec %} |
| 27 | +If your {% data variables.product.prodname_github_app %} is public, other users and organizations {% ifversion ghae or ghec %}within your enterprise {% endif %}can install your app. For more information about making your app public, see "[AUTOTITLE](/apps/creating-github-apps/setting-up-a-github-app/making-a-github-app-public-or-private)." |
| 28 | + |
| 29 | +{% ifversion ghec %}If you are an {% data variables.product.prodname_emu %}, then you can only share your app with other users or organizations within your enterprise.{% endif %} |
| 30 | + |
| 31 | +{% else %} |
| 32 | +{% endif %} |
| 33 | + |
| 34 | +{% data reusables.apps.settings-step %} |
| 35 | +{% data reusables.user-settings.developer_settings %} |
| 36 | +{% data reusables.user-settings.github_apps %} |
| 37 | +1. Next to the {% data variables.product.prodname_github_app %} that you want to share, click **Edit**. |
| 38 | +1. Click **Public page**. {% data variables.product.company_short %} will bring you to the public page for your {% data variables.product.prodname_github_app %}. |
| 39 | +1. Click **Install**. {% data variables.product.company_short %} will bring you to the installation URL for your {% data variables.product.prodname_github_app %}. The URL will look something like `{% data variables.product.oauth_host_code %}/{% ifversion ghes or ghae %}github-apps{% else %}apps{% endif %}/APP-NAME/installations/new`, where `APP-NAME` is the name of the {% data variables.product.prodname_github_app %}. |
| 40 | +1. Share the installation URL with other users. For more information about how users can install your app from this URL, see "[AUTOTITLE](/apps/using-github-apps/installing-a-github-app-from-a-third-party)." |
| 41 | + |
| 42 | + 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 the `state` to correlate an installation to a user or account. |
| 43 | + |
| 44 | + To preserve a state, add it to the installation URL: `{% data variables.product.oauth_host_code %}/{% ifversion ghes or ghae %}github-apps{% else %}apps{% endif %}/<app name>/installations/new?state=AB12t` |
0 commit comments