Source Control

Connect and manage source control providers for your Laravel Cloud applications.

Introduction

Laravel Cloud deploys your application by connecting to a Git provider. Cloud supports GitHub, GitLab, and Bitbucket.

Connecting a source control provider

To connect a source control provider, go to “Account settings > Source controls”.

Select a provider and go through the OAuth flow to authorize the connection.

For GitHub, you may be asked to install the Laravel Cloud App on the GitHub account or organization that owns your repositories. This controls which repositories Cloud can access. GitLab and Bitbucket do not require this step.

Connecting the same Git to multiple Cloud accounts

You can connect the same Git account to more than one Laravel Cloud user.

Each connection is separate: disconnecting Git from one Cloud account does not disconnect it from the others. To fully remove a Git account connection from Laravel Cloud, all Cloud users using that Git account must be disconnected.

Disconnecting a source control provider

You can disconnect a provider from “Account settings > Source control”. Click the ”…” next to the provider and then “Disconnect”.

This will affect all applications that rely on that connection, across all organizations under the same Cloud user. Those applications will continue running but will not be able to deploy until the repository is reconnected by you or another user with access to the repository.

Refreshing tokens

If your provider token expires or you need to re-authorize access, go to “Account settings > Source control”, click the ”…” next to the provider, and then “Reauthorize”.

Troubleshooting

I can’t find my repository

There are two potential reasons we can’t find your repository:

1. Your Github user doesn’t have access to the repository

Laravel Cloud follows GitHub’s permissions, displaying only the repositories your GitHub user has access to.

To check whether your GitHub has access to the repository:

• Go to github.com
• Log in using the same user you’ve authenticated on Laravel Cloud
• Search your list of repositories

If it’s not available in that list, it will not be available in Laravel Cloud. You may need to request access from the owner of the repository.

2. The Laravel Cloud app doesn’t have the permissions to access the repository

The Laravel Cloud GitHub app must be granted access to the repositories you wish to import.

To check the Laravel Cloud app’s permissions:

• Go to the Laravel Cloud app installation settings on GitHub
• Select your GitHub account
• Select ‘All repositories’ (or select your repositories)
• Hit Save

If you are using Gitlab or Bitbucket, make sure you have access to that repository on the provider’s side. Laravel Cloud follows the provider’s permissions.

Missing GitHub installation

If you encounter the “Missing GitHub installation for ‘your name’, please re-install” error, it means GitHub has failed to send us the confirmation webhook during the installation of the Laravel Cloud GitHub application into your GitHub account.

To fix this:

• Go to the Laravel Cloud app installation settings on GitHub
• Select your GitHub account
• In the Danger zone section, click Uninstall
• Back on Laravel Cloud, go to Overview > + New application
• Go through the authorization process again