Connect GitHub

GitHub uses the repository-scoped ScrinCloud GitHub App and short-lived installation access. Use an organization-owned installation and select only the repositories approved for ScrinCloud.

Typical time

10–15 minutes

You need

ScrinCloud admin and GitHub App approval

Optional

Project-admin access for repository creation

Step 1: Start GitHub authorization

1. open Git Integration;
2. find the GitHub provider card; and
3. choose Connect GitHub.

ScrinCloud opens GitHub authorization. If the app is not configured for the environment, the page reports that application credentials are unavailable.

GitHub 1 of 5 · Screenshot placeholder

Start the GitHub connection

Show the GitHub provider card with Connect GitHub before leaving ScrinCloud.

Future capture briefUse an empty documentation account. Do not show a real organization, owner, repository, email, or application configuration.

Step 2: Install and scope the GitHub App

In GitHub:

1. choose the approved personal account or organization;
2. install the ScrinCloud GitHub App;
3. prefer Only select repositories unless policy explicitly permits all repositories; and
4. approve the installation.

Do not grant broader organization or repository access than the intended Terraform workflow requires.

GitHub 2 of 5 · Screenshot placeholder

Scope the GitHub App installation

Show a staged GitHub App repository-scope choice with synthetic repository names.

Future capture briefReplace the organization, avatar, users, repositories, installation ID, callback URL, and any private metadata.

Step 3: Return and verify the owner

GitHub returns to Git Integration. ScrinCloud validates the installation and connection state, then shows the connected GitHub accounts.

Confirm:

• the success notice says GitHub is connected for the organization;
• the intended owner appears in Connected Accounts; and
• the owner type is Organization or User as expected.

Choose Refresh access if GitHub permissions or repository selection changed.

GitHub 3 of 5 · Screenshot placeholder

Verify the connected GitHub owner

Show a synthetic GitHub owner with Connected status and Refresh access.

Future capture briefHide owner identity, avatar, repository data, installation ID, connection ID, OAuth state, and any provider response.

Step 4: Set the default GitHub owner

Open the GitHub account row menu and choose Set as default owner. The default marker is used when new GitHub repository workflows need an owner.

This action is GitHub-only. GitLab and Azure DevOps accounts do not expose it in the current product.

GitHub 4 of 5 · Screenshot placeholder

Set a default GitHub owner

Show the GitHub row action and the resulting Default marker on a synthetic owner.

Future capture briefUse a documentation-only owner. Do not show organization membership, repository names, or provider IDs.

Step 5: Create a project repository

Repository creation requires project-admin access:

1. choose Create repository on the connected GitHub owner;
2. choose an eligible project;
3. review the generated repository name;
4. keep the default branch as main unless your policy requires another branch;
5. keep visibility Private unless the organization has approved Internal or Public; and
6. choose Create repository.

The product initializes the repository and records it against the project. Repository creation does not authorize Terraform apply.

GitHub 5 of 5 · Screenshot placeholder

Create a private project repository

Show the create-repository dialog with a synthetic project, repository name, main branch, and Private visibility.

Future capture briefUse documentation-only names. Hide organization, owner, project ID, repository URL, connection ID, and any generated credential.

Check your result

Confirm the expected GitHub owner is connected, refresh succeeds, the optional default marker is correct, and any new repository exists under the intended owner with the reviewed visibility and default branch.

Common blockers

Installation was cancelled or rejected

Start Connect GitHub again and have an authorized GitHub owner approve the app and repository scope.

No eligible project appears

Repository creation needs project-admin access. Ask a project admin to create the repository or grant the correct project role.

A repository is missing from access

Update the GitHub App installation repository selection, then choose Refresh access in ScrinCloud.

Existing project repository setup

A project can also link an approved existing GitHub repository URL through its repository controls. Confirm the connected owner has access before saving.