
GitHub prompt for Gitpod OAuth App permissions with user:email scope
Starting Workspaces
To start a new workspace after logging into Gitpod, useCtrl/Cmd + O
or click on the New Workspace button in https://gitpod.io/workspaces. This will prompt for a repository URL, or suggest recent repositories opened with your account.
You can also start a Gitpod workspace using a GitHub repository URL. Simply point your browser to the repository URL prefixed with gitpod.io/#
as described in Getting started.
Granting additional GitHub OAuth permissions
GitHub requiresrepo
scope permissions to open a workspace on a private repository, or to push code changes from a workspace back to your repository.
You can grant these additional permissions for GitHub under User Settings
> Git Providers
using the context menu on the right.

Gitpod settings for GitHub integration permissions
Errors with private repositories on GitHub orgs
If you encounter errors setting up a Gitpod project on a private repository in a GitHub org, you may need to approve the Gitpod OAuth app for 3rd party access to the org.- In the OAuth app configuration, look for the org in question in the lower section of the page under ‘Organization access’.
- Click on the
Grant
button. If you don’t have direct permission to authorize 3rd-party integrations, you can hitRequest
to notify the org admin to approve the request for you.