Skip to main content
Porter needs its GitHub App installed on a repository before it can detect applications, build from source, or create a GitHub Actions deployment workflow. This prerequisite applies whether you create the application with an agent or in the dashboard.
1

Open the repository connection flow

In the Porter dashboard, open your project and click Create Application, then click Connect repositories.
2

Install the Porter GitHub App

GitHub opens the authorization and installation flow. Choose the GitHub account or organization that owns the repository and authorize the Porter GitHub App.Depending on your GitHub organization settings, you may need to request the installation and wait for an organization administrator to approve it.
3

Choose repositories

Grant Porter access to all repositories or select the specific repositories you want to deploy.
After installation, return to Porter. You can now deploy from the GitHub repository with an agent or the dashboard.