Skip to main content
A source integration links your Upsun project to a third-party Git repository (GitHub, GitLab, or Bitbucket), making that repository the source of truth. Upsun mirrors the repository and manages environments based on your repository’s branch and pull request activity. For example:
  • When you open a pull request, Upsun spins up an identical preview environment that reflects the contents of the pull request.
  • After you push code to your external repository, Upsun mirrors the updated code and redeploys the affected environments.
This integration enables you to keep your code and CI/CD workflows on your Git provider of choice and use Upsun for deployment.
If you connect an external repo to Upsun, do not push code directly to Upsun: push to your external repository.Upsun overwrites any changes pushed to it directly in order to mirror the external repository.

Bitbucket

Manage your Upsun environments directly from your Bitbucket repository.

GitHub

Manage your Upsun environments directly from your GitHub repository.

GitLab

Manage your Upsun environments directly from your GitLab repository.

Troubleshoot

Resolve access rights issues with integrated repositories.
Last modified on June 25, 2026