Connecting Your GitHub Account
MaxPlane uses a separate GitHub OAuth connection for repository access. This is independent of any GitHub account you may have used to sign in to MaxPlane — the repo connection requests broader permissions so it can read your repositories, manage deploy keys, and register webhooks.
What Permissions Are Requested
When you connect GitHub for repo access, MaxPlane requests the following OAuth scopes:
repo— Full access to your public and private repositories. This is required to clone code, add deploy keys, and create webhooks.read:org— Read-only access to your organization memberships. This allows MaxPlane to list repositories from organizations you belong to.
Connecting Your Account
- Navigate to any app's detail page and open the Git & Deploy tab.
- You will see a Connect GitHub button with the GitHub logo. Click it.
- You will be redirected to GitHub's authorization page. Review the requested permissions and click Authorize.
- GitHub redirects you back to MaxPlane. Your connection is saved to your user account.
- The Git & Deploy tab now shows a repository browser instead of the connect button.
Once connected, GitHub access is available across all your apps — you only need to connect once.
Disconnecting Your Account
To revoke MaxPlane's access to your repositories:
- Go to GitHub Settings > Applications.
- Find the MaxPlane OAuth application under Authorized OAuth Apps.
- Click Revoke to remove access.
This revokes access on GitHub's side. Any apps that were connected to a repo will retain their existing configuration, but new repo connections will require re-authorization.
Troubleshooting
- "Failed to load repositories" — Your connection may have expired or been revoked. Disconnect and reconnect your GitHub account.
- Private repos not showing up — Make sure you granted the
reposcope. If you denied it during authorization, revoke the app on GitHub and reconnect. - Organization repos missing — If your organization has OAuth app restrictions enabled, an org admin must approve the MaxPlane OAuth app before org repos will appear.