Connect GitHub
Install kosem's GitHub App on your account or organization, so that access profiles can issue short-lived tokens for its repositories.
Connect a GitHub account or organization by installing kosem's GitHub App on it. Access profiles then issue installation tokens for its repositories, such as for an agent that pushes a branch. To do it, you need Owner or Connection Admin on the kosem organization, or on the project for a project's own connection, and, on GitHub, to own the account, or be an owner of the GitHub organization.
Connect GitHub
- In your organization, click Access, then Connections.
- Click Connect an account, and select GitHub.
- Optionally, enter a Name (optional). Left empty, the connection is named after the GitHub account.
- Click Continue to GitHub.
- On GitHub, select the account to install the app on, select the repositories it can access, and install it.
GitHub brings you back to kosem, which connects the installation and opens the connection. Its Overview shows the repositories the app can access.
From the connection page, create an organization Access profile (and share that profile with projects), or open the Sharing tab to share the connection directly with selected projects.
Connect GitHub for one project
- In the project, click Access, then Connections.
- Click Connect an account, and select GitHub.
- Follow steps 3 to 5 above.
GitHub brings you back to the project's connection, which only that project's access profiles use. If the page says a policy keeps projects from connecting accounts of their own, your organization turned on Turn off projects' own connections.
Connect an app you installed already
If you installed kosem's app on GitHub before, or connecting failed after GitHub installed it:
- Click Connect an account, and select GitHub.
- Click Connect the installation, and sign in to GitHub.
kosem connects the installation of an account you own.
Change which repositories it reaches
kosem's app reaches what you gave it on GitHub, and each access profile selects a subset of those repositories.
- On the connection's Overview, click Manage on GitHub.
- Select the repositories on GitHub, and save.
kosem's app asks for permission to write contents, pull requests, issues and workflows, and to read actions, checks, statuses and your organization's members. Each access profile asks for less.
If it fails
- The installation is connected elsewhere. An installation belongs to one kosem organization, or to one of its projects. Ask whoever connected it, or install the app on another account.
- You don't manage the account. kosem connects only an installation on your own account or an organization that you own on GitHub. Ask an owner of the GitHub organization to connect it.