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.

​
Connect with an agent

An agent connected to Porter’s MCP server can check the repository and take you directly to the GitHub step that is still required.
1

Ask your agent to connect the repository

The agent calls connect_github with the repository in owner/name form.
2

Complete the returned action

If the agent returns a URL, open it to authorize GitHub, install the Porter GitHub App, or add the repository to an existing installation. If the repository is already reachable, the agent skips this step and continues.Open an OAuth authorization link while signed into the same Porter account your agent uses. An organization owner has to approve an installation when the repository’s organization does not already have one.
3

Continue after Porter can reach the repository

Ask the agent to check again after completing the action. It proceeds only after connect_github reports that the repository is reachable.

​
Connect from 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.