Import a repo
This page covers connecting a GitHub repository to a project so the app can deploy it.
Prerequisite: signed in.
Install the GitHub App
The app uses a GitHub App (named Aleph Cloud App on GitHub) to access your repositories. The first time you connect a repo, the New Project wizard prompts you to install it.
- Click New project in the dashboard
- The wizard opens; if you haven't connected GitHub yet, click Install GitHub App
- GitHub asks which account or organization should host the install — pick the one that owns the repo you want to deploy
- GitHub asks which repositories the App can access — pick Only select repositories and choose specific repos, or All repositories to give it access to everything (you can change this later)
- Click Install
GitHub redirects you back to the wizard. You should now see the Select Repo step with a list of repositories.
Pick a repository
The Select Repo step shows your accessible repositories with a status column:
| Status | Meaning |
|---|---|
| Available | Not yet imported into the app — pick this to create a new project |
| Imported | Already imported as a different project — clicking shows an alert with a link to open the existing project |
If your repository list is empty:
- The App is installed but you didn't grant access to any repositories. Click Manage repo access at the top of the step (links to your GitHub install settings) and grant access to the repos you want.
- Refresh the wizard. The list should populate.
Manage access later
Repository access is managed on github.com, not in the app. Two paths to change it:
- From the wizard — click Manage repo access to open your install settings on GitHub
- From the app — go to Settings → Integrations. The current GitHub install is shown with two actions:
- Manage on GitHub — opens your install settings (same as above)
- Disconnect — removes the install from the app's records, then opens GitHub for you to complete the uninstall
Disconnect
If you uninstall the App on GitHub directly (without using the in-app Disconnect), the app receives a webhook from GitHub and cleans up its internal records automatically. You don't need to do anything in the app.
After disconnect, your existing projects' deployments are unaffected (they're already pinned on IPFS). The app just can't trigger new deployments until you reconnect.
Verification
You should now see:
- A repository selected in the wizard
- The wizard advances to the framework-detection step (covered in Your first deployment)