How to connect your GitHub account to Zenifra
To use GitHub repositories on Zenifra, you need to complete two steps: link your GitHub account to your Zenifra account and install the Zenifra GitHub App on the personal account or organization that owns the repositories.
Prerequisites
- An active Zenifra account
- A GitHub account
- Permission to install apps on GitHub in the target account or organization
Step 1 — Link your GitHub account to Zenifra
- Sign in to the Zenifra console.
- Open your account settings.
- Start the connection to your GitHub account.
- Authorize the link between GitHub and Zenifra.
This link identifies which GitHub user will be used by Zenifra. It does not grant repository access by itself. Repository access depends on installing the Zenifra GitHub App.
Step 2 — Install the Zenifra GitHub App
After linking the account, open the app installation page:
During installation, GitHub asks you to choose where the app will be installed and which repositories may be used by Zenifra.
App installation defines which accounts and which repositories Zenifra can see when creating or updating GitHub-based projects.
Step 3 — Choose personal account or organization
Personal account
Choose your personal account when the repositories you want to use belong to your GitHub user. This is the simplest flow for personal projects, tests, and individual applications.
Organization
Choose an organization when the repositories belong to a shared GitHub workspace. Depending on the organization's rules, app installation may require approval from an administrator before becoming available.
If you work with more than one organization, install the app separately in each one that should make repositories available to Zenifra.
Step 4 — Choose the repositories
During installation, GitHub usually offers two options:
- All repositories: automatically grants access to current and future repositories in that account or organization.
- Only selected repositories: grants access only to repositories chosen manually.
If you want to limit initial access, prefer manual selection. If the expected repository does not appear later in the Zenifra console, review the app installation and confirm it was included.
How to confirm the integration worked
After completing the installation:
- Return to the Zenifra console.
- Start the creation or editing flow of a GitHub-based project.
- Check whether the correct personal account or organization appears.
- Confirm whether the expected repository is available for selection.
If the account appears but a specific repository does not, the account link is working and the needed adjustment is probably in app installation or repository selection.
Troubleshooting
The repository does not appear on Zenifra
Check whether the Zenifra app was installed in the correct account and whether the repository was included in the installation. This is common when the installation used the selected repositories option.
The organization does not appear on the installation page
Confirm whether your GitHub user has permission to install apps in that organization. Some organizations also restrict installation to administrators.
The app was installed, but access is still missing
Some organizations require extra approval after the installation starts. In those cases, ask an administrator to review and complete the authorization.
I installed the app in the wrong account
Open the app installation page again and repeat the process, choosing the correct personal account or organization.