---
title: Git (HTTP/S) Integration
description: Learn how to connect any Git repository over HTTP/S to Capawesome Cloud to build and automate your app directly from source.
---

# Git (HTTP/S) Integration

Connect any Git repository reachable over HTTP or HTTPS to Capawesome Cloud to build and automate your app directly from source. Use this provider for any Git server that is not GitHub, GitLab, Bitbucket, Azure DevOps, or Gitea. A Git connection stores your provider and credentials once at the organization level and can be reused by any app in that organization.

## Prerequisites

Before you begin, ensure you have:

- A [Capawesome Cloud](https://console.cloud.capawesome.io){:target="_blank"} account and an organization (owner or admin role to manage Git connections).
- A Git repository reachable over HTTP or HTTPS (HTTPS recommended), and credentials for it if it is private.

## Create a Git connection

A Git connection is created once at the organization level and can be reused by every app in that organization.

1. Open your organization's [Git connections](https://console.cloud.capawesome.io/organizations/_/git){:target="_blank"} page and click **Create Git connection**.
2. Select **Git (HTTP/S)** as the provider.
3. Follow the steps below to authenticate with a username and password.

### Username & password

Git (HTTP/S) connections authenticate with basic auth against a plain smart-HTTP(S) remote.

1. Select **Username & password** as the authentication method.
2. Enter the username and password for the repository. Leave both empty for public repositories.

!!! tip "Token-only providers"

    Some Git hosts authenticate with a token instead of a username and password. On GitHub, for example, leave the **username** empty and paste a personal access token (PAT) with repository read access as the **password**.

## Connect a repository to your app

Because there is no provider API to browse repositories, you paste the repository URL directly:

1. Open your app's [Git repository](https://console.cloud.capawesome.io/apps/_/git){:target="_blank"} page and click **Connect Git repository**.
2. Select the Git (HTTP/S) connection.
3. Paste the full **Clone URL** of the repository (e.g. `https://git.example.com/team/my-app.git`).

You can also connect a repository during **Create app** (on the **Git** tab).

!!! warning "No automations"

    Git (HTTP/S) connections don't support webhooks, so [Automations](../automations/index.md) are unavailable. Commit details are also limited to the commit SHA — no author, message, or branch information, and no commit links.