# Connect your Git Provider to Render — Deploy from GitHub, GitLab, Bitbucket, and Cursor Origin.

Render integrates with the following Git providers:

- GitHub
- GitLab
- Bitbucket
- Cursor Origin (beta)

After you connect your Git provider to Render, you can deploy services using any repository you have access to. Render automatically redeploys your service with every push to its linked branch (you can [disable this](/deploys#configuring-auto-deploys)).

Connecting your Git provider also enables [pull request previews](#previewing-pull-requests) and [provider-based sign-in](#signing-in-with-your-git-provider).

## Setup

*Select the tab for your provider:*

**Tab: GitHub / GitLab / Bitbucket**

### GitHub / GitLab / Bitbucket setup

1. Open your [Account Settings](https://dashboard.render.com/u/settings#account-security) page and scroll down to the *Account Security* section:

    [image: Connecting your Git provider]

2. Under *Git Deployment Credentials*, click *Add credential* and select the Git provider you want to connect.

    This opens an authorization/connection flow with your Git provider.

3. Review the details of the connection and confirm.
    - For GitLab, your account must have at least *Maintainer* or *Owner* permissions on a project to enable [automatic deploys](/deploys#automatic-deploys) for it.

**Tab: Cursor Origin (beta)**

### Cursor Origin setup

> *Cursor Origin and its Render integration are currently in beta.*
>
> Currently, only *admins* of a Cursor workspace can connect Cursor Origin to their Render account.

As an *admin* of your Cursor workspace, you can connect Cursor Origin to your Render account with the following steps:

1. Open your [Account Settings](https://dashboard.render.com/u/settings#account-security) page and scroll down to the *Account Security* section:

    [image: Connecting your Git provider]

2. Under *Git Deployment Credentials*, click *Add credential* and select *Cursor Origin*.

3. A new browser window opens and navigates to Cursor, where you can install the Render app for the Cursor workspace:

    [image: Installing the Render app in Cursor]

You're all set! Whenever you [create a service](https://dashboard.render.com/new), you can link any repository from your connected providers:

[image: List of connected repos in the Render Dashboard]

## Previewing pull requests

Render can automatically build and deploy a preview of your service for every pull/merge request opened against your service's linked branch:

[image: Service preview in GitHub pull request]

- Every PR preview is deployed to a unique `onrender.com` subdomain.
- Render redeploys a PR preview with every push to the PR's branch.
- Render automatically deletes a PR preview when its PR is merged or closed.

Pull request previews work with all supported Git providers. For details, see [Service Previews](service-previews#pull-request-previews-git-backed).

## Signing in with your Git provider

> *Sign-in with Cursor Origin is not supported.*

You can sign up for Render and sign in to the [Render Dashboard](https://dashboard.render.com) with your GitHub, GitLab, or Bitbucket identity:

[image: Logging in with your Git provider]

If you already have a Render account that matches your Git provider account's primary email address, Render logs you in to the existing account automatically.

Learn more about [managing login methods](login-settings#managing-login-methods).

## Git submodules

If your repository defines a `.gitmodules` file at its root, Render automatically reads it and clones all specified [Git submodules](https://git-scm.com/book/en/v2/Git-Tools-Submodules) as part of your service's build process.

Render attempts to clone Git submodules using the credentials associated with your connected Git provider. Private submodules must be accessible with those credentials.

## Provider-specific details

**Tab: GitHub**

### GitHub details

#### Troubleshooting

If your GitHub deploys aren't working as expected, this might be caused by misconfiguration of Render's GitHub app. For example, it might be configured for the wrong set of repositories, or a repository that was previously public might have been made private.

##### Fixing GitHub app permissions

Visit [github.com/apps/render/installations/new](https://github.com/apps/render/installations/new) to install the Render app in a new organization or configure an existing installation:

[image: Configure GitHub]

From here, check the *Repository access* section to make sure your repository is included.

[image: Selecting connected GitHub repositories]

##### Team-specific issues

If the creator of a Render service loses access to that service's connected GitHub repository, it can disrupt deploys for that service. You can update the Git credentials used to deploy a service from the service's *Settings* page in the [Render Dashboard](https://dashboard.render.com):

[image: Git Credentials]

Before you make this change, make sure that the new credentials have access to the service's Git repository.

**Tab: Cursor Origin (beta)**

### Cursor Origin details

> *Cursor Origin and its Render integration are currently in beta.*
>
> Currently, only *admins* of a Cursor workspace can [connect Cursor Origin](#cursor-origin-setup) to their Render account.

#### GitHub-mirrored repositories

Cursor Origin supports [mirroring GitHub repositories](https://cursor.com/docs/origin/mirror-github). The following Render features are unavailable for mirrored repositories:

- [Automatic deploys](/deploys#automatic-deploys)
- [Pull request previews](service-previews#pull-request-previews-git-backed)

To use these features, you can connect the original GitHub repository to your service instead of its Cursor Origin mirror.

