Connect GitHub accounts

Projects use repositories that the Software Factory GitHub App can reach. Connect the app first.

1. Open Settings → GitHub and click Connect GitHub. You can also start from Get started on the Projects page.
2. GitHub asks where to install the app. Choose your personal account or an organization, and choose All repositories or the repositories the portal may use.
3. GitHub sends you back to Settings → GitHub with GitHub is connected.

The connection belongs to the current workspace. Everyone in the workspace can use its repositories.

What the portal checks

The setup URL GitHub redirects to carries an installation_id that anyone could type, so the backend checks that the installation belongs to you before it saves it:

• Personal account: the installation account must be your GitHub user.
• Organization: you must be an active member of the organization. The app’s Members: Read-only organization permission makes this check possible.

An installation can be connected to only one workspace.

Organization approvals

When an organization member who is not an owner installs the app, GitHub asks an organization owner to approve it. The portal shows that the request was sent. Once the owner approves, connect again.

Give the app more repositories

Open Settings → GitHub and click Manage on GitHub next to the account. It opens the installation settings on GitHub, where you change the repository selection. The repository picker also links there.

Create repositories

The repository picker can create a repository, but only in organization accounts: the GitHub App cannot create repositories for a personal account. For a personal account, create the repository on GitHub, give the app access to it, then pick it in the portal.