Git Repository Reference
This technical reference details repository authentication models, permission requirements, webhook payload matching, monorepo directory resolution, and self-hosted Git integrations.
GitHub Authentication Architecture
Hubfly space utilizes two distinct GitHub access mechanisms:
- GitHub OAuth Link: Identifies your user identity and allows browsing repositories in your personal GitHub account.
- GitHub App Installation: Grants explicit repository deployment permissions for organization-owned repositories. If organization repos do not appear in the dropdown, install the Hubfly space GitHub App on that GitHub Organization.
Self-Hosted Git Integration
Connect self-hosted GitLab, Bitbucket, Gitea, or Forgejo instances using personal access tokens.
- Token Scope Requirements: Token requires
read_repositoryandread_apiprivileges. - Webhook Endpoint URL: Send JSON push/CI events to:
https://hubfly.space/api/selfhosted/webhook
Monorepo Root Directory Resolution
When your application lives in a monorepo subfolder, set Root Directory (e.g. apps/frontend). Hubfly space Builder will resolve build scripts, package managers, and Dockerfile relative to that subfolder.