Connect your repository
You can connect GitHub through a GitHub app or Bitbucket and GitLab repositories to your build profile through OAuth apps. Alternatively, you can connect private repositories through SSH and public repositories directly on GitHub, Bitbucket, GitLab, and other compatible Git providers such as Azure DevOps and AWS CodeCommit. (Please refer here for more information on AWS CodeCommit connections.)
You can also connect to your self-hosted Bitbucket and GitLab account directly within Appcircle.
If you authorize Appcircle to connect to your Github, BitBucket, or GitLab account, you can auto-build your project with hooks, get build statuses, and the full list of commits. If you connect to a repository through SSH or through a public URL, you need to set up webhooks manually.
When the "Autofill" toggle is activated on the Select Repository popup, Appcircle will try to create a default configuration using the selected repository and fill in the necessary fields.
When you have exceeded the build limit of your plan, Appcircle will not be able to Autofill your build profile, although you activated the toggle.
You can refer to the links below for a detailed explanation on connecting a repository from GitHub, GitLab, Azure, and other platforms:
- Connecting to GitHub
- Connecting to GitLab
- Connecting to Bitbucket
- Connecting to Azure DevOps
- Connecting to Public Repository
- Connecting to Private Repository via SSH
- Connecting to Multiple Instances
FAQ
Repository Connection Issues
Please note that currently only Git repositories are supported. Any third party version control repositories need to be transferred to a proper Git repository on either GitHub or Bitbucket.
How to change your connected GitHub, Bitbucket, or GitLab account?
You will need to go to your GitHub, Bitbucket, or GitLab account and revoke access to Appcircle and then reconnect your account from Appcircle.
Unable to see the repositories in the connected repository provider
Please check if you have owner/admin access in the specific organization from which the repositories will be connected. Appcircle does not allow connections to the repositories with a member-level access.
Error accessing the repository. Please check if the repository exists or if you have the required privileges.
- Only members who have an admin role on the repository or are owners of the organization can install the GitHub app in an organization that owns that repository.
- Only members who have an admin role on a repository or are owners of the organization can connect a repository to a profile.
If you still can't solve your issues, ask on our Slack page. Our community and our support engineers will help you whenever they're available:
Need help?
Get help from Appcircle's support team, or see how others are using Appcircle by joining our Slack Channel.
