GitHub Integration — Connect GitHub and Manage Repositories on EasyCloudify™
TL;DR — Connect your GitHub account to EasyCloudify™ once via OAuth, then import and manage repositories directly from the Serverless section to enable GitHub-based app deployments.
What is EasyCloudify™ GitHub Integration?
EasyCloudify™ GitHub Integration is the OAuth-based connection between your GitHub account and the EasyCloudify™ platform that allows you to deploy applications directly from GitHub repositories without manually building Docker images. Once connected, EasyCloudify™ can read your repositories, trigger builds on push, and sync deployments. Access GitHub settings from /cloudpanel/serverless.
Before You Start
- You have an active Serverless plan subscription
- You have a GitHub account
How to Connect Your GitHub Account
Step 1 — Open GitHub Settings
Navigate to /cloudpanel/serverless. In the page header, click the GitHub Settings button (with a Settings icon). The GitHub Settings Modal opens.
Step 2 — Authorize via OAuth
Inside the modal, click the connect button to initiate the GitHub OAuth flow. You are redirected to GitHub to authorize EasyCloudify™.
Step 3 — Complete Authorization
Approve the permissions on GitHub and you are redirected back to EasyCloudify™. The OAuth callback is handled automatically.
On success: A toast notification confirms "GitHub connected successfully." The URL is cleaned of OAuth parameters.
On error: If the OAuth flow fails, EasyCloudify™ shows a specific error toast based on the failure reason:
| Error | Message |
|---|---|
| Access denied | github_oauth_access_denied |
| Invalid callback | invalid_oauth_callback |
| State mismatch | state_mismatch |
Step 4 — Verify Connection
After successful OAuth, the GitHub Settings modal shows your connected GitHub account.
How to Manage Repositories
Step 1 — Open Repositories
In the Serverless page header, click the Repositories button (with a FolderGit2 icon). The Repositories Management Modal opens.
Step 2 — Import a Repository
Inside the Repositories Management Modal, you can:
- View all repositories accessible to EasyCloudify™
- Import repositories to make them available for deployments
- Sync an existing repository to fetch the latest branches and commits
- Delete a repository connection from EasyCloudify™ (does not delete the repository on GitHub)
- Restore a previously removed repository connection
Step 3 — Use a Repository for Deployment
After importing a repository, it becomes available as a source option in the Serverless Deployment Wizard.
How to Trigger a Sync Deployment
On an existing serverless application's detail page at /cloudpanel/serverless/application/[id]:
- Click Sync GitHub in the page header.
- A confirmation modal appears: "Trigger a new deployment from the current GitHub branch?"
- Click Sync to confirm. EasyCloudify™ triggers a new build from the current GitHub branch.
How to Disconnect GitHub
Open the GitHub Settings Modal from the Serverless page and use the disconnect option to remove the GitHub OAuth connection.
Troubleshooting
Issue: OAuth returns a state_mismatch error.
Why it happens: The OAuth state parameter did not match — typically caused by opening multiple tabs or a browser that clears session storage.
Fix: Close extra tabs, clear your browser session data, and try connecting again.
Issue: My repositories are not appearing after connecting. Why it happens: Repositories must be imported in the Repositories Management Modal before they appear as deployment sources. Fix: Open the Repositories modal and import the repositories you want to use.
Frequently Asked Questions
Does EasyCloudify™ have access to all my GitHub repositories?
EasyCloudify™ only accesses repositories you explicitly import in the Repositories Management Modal.
Can I connect multiple GitHub accounts?
EasyCloudify™ supports one connected GitHub account per user. To switch accounts, disconnect the current one first.