Git Integrations

Git integrations connect Kovra to your GitHub or GitLab accounts, enabling repository access, template-based application creation, and deployment workflows.

Connecting a Provider

1. Go to Settings → Integrations
2. Click Connect next to GitHub or GitLab
3. You’ll be redirected to the provider’s OAuth consent screen
4. Grant the requested permissions
5. Once approved, the integration appears in your connected list

GitHub Permissions

GitHub integrations request access to:

• Repositories — Read and write access to your repos
• Organizations — Visibility into your org structure
• Webhooks — Create and manage deployment webhooks

GitLab Permissions

GitLab integrations request full API access for:

• Repository management
• CI/CD pipeline configuration
• Webhook setup

What Integrations Enable

Once connected, you can:

• Create applications from templates — Select a template, pick your connected account, and Kovra auto-creates a repository with the template code
• Import existing repositories — Browse and import repos from your connected accounts
• Trigger pipelines — Run CI/CD pipelines from the Kovra dashboard
• GitOps deployments — Deploy applications from your repositories

Managing Integrations

Each connected integration shows:

• Provider — GitHub or GitLab
• Account name — Your username or organization
• Connected date — When the integration was set up

Disconnecting

Click Disconnect to revoke OAuth access. Note:

• Repositories created through Kovra remain in your Git provider
• Applications using the integration will need to be reconfigured with a new integration
• In-progress deployments may fail