Skip to content

GitHub App Registration

Connect a GitHub App to CloudPie to enable secure repository discovery and authentication without personal access tokens.

Prerequisites

  • Organization admin access in CloudPie
  • Admin access to your GitHub organization
  • A GitHub App created (App ID, Private Key .pem, and Installation ID)

Navigate to This Page

  1. Open the Dashboard.
  2. In the sidebar, click Settings → GitHub App Registration.

Example Image: GitHub App Registration Page
GitHub App Registration Page

Create a GitHub App (if needed)

  1. In GitHub, go to Settings → Developer settings → GitHub Apps → New GitHub App.
  2. Recommended permissions:
  3. Repository contents: Read‑only
  4. Metadata: Read‑only
  5. Download the Private Key (.pem), and note the App ID.
  6. Install the app to your organization and note the Installation ID (from the URL).

Register the App in CloudPie

  1. Enter your GitHub App ID (numeric).
  2. Paste the Private Key (.pem) into Update Private Key.
  3. Enter the Installation ID (e.g., from https://github.com/settings/installations/84275342 → 84275342).
  4. Click Register to save.

You can re‑register at any time; CloudPie will overwrite old credentials.

Notes

  • Keep the .pem key secure; rotate in GitHub if compromised and update here.
  • After registration, projects can search repositories via the GitHub App; manual URL + token remains available.