How to Link a GitHub Repository to a New Project

Last updated: September 19, 2025

If you're having trouble creating a new project and linking it to a GitHub repository, even though the Porter GitHub app is installed in your organization, follow these steps:

  1. Click on the user icon in the top right corner of your Porter dashboard.

  2. Select "Account Settings" from the dropdown menu.

  3. Check if your GitHub integration is enabled on the Account Settings page.

  4. If it's not enabled, turn on the GitHub integration.

  5. Return to the app creation flow and try linking your GitHub repository again.

Why This Works

Sometimes, even if the Porter GitHub app is installed in your organization, the integration might not be enabled in your account settings. Enabling it in your Account Settings ensures that Porter has the necessary permissions to access and link your GitHub repositories when creating new projects.

Troubleshooting

If you're still experiencing issues after following these steps, please ensure that:

  • The Porter GitHub app has the necessary permissions to access the specific repository you're trying to link.

  • You are an admin in your GitHub organization. Currently, we only support GitHub organization admins in creating apps in Porter.
    If you're not an admin, ask an admin to create the app for you.
    Note: Each team member must individually authorize Porter in their Account Settings, but only organization admins will be able to deploy apps based on GitHub repositories.

  • Try re-authorizing your GitHub connection: Click in the user icon in the top-right of the dashboard, then on Account Settings, click "Authorize to GitHub" to refresh your OAuth connection, even if the integration appears to be already enabled.

If problems persist, don't hesitate to reach out to Porter support for further assistance.