This article has been archived. Please see Coder Docs for the updated version.
The Git Integration allows your developers to connect their Coder accounts to their accounts with the Git repository service of choice.
Support
Currently, Coder supports the following providers:
- GitHub (both GitHub.com and GitHub Enterprise)
- GitLab (both GitLab.com and self-hosted GitLab)
- Bitbucket Server (not Bitbucket Cloud; the Cloud API doesn't support managing SSH keys for users via
OAuth)
Configuring OAuth
Before developers can link their accounts, you (or another administrator) must create an OAuth application with the appropriate providers. When registering, you'll be asked for the following details related to your Coder deployment.
GitHub
When creating an OAuth app, GitHub will ask you for the following Coder parameters:
- Homepage URL: Set to
[your-coder-domain]
(e.g.https://coder.domain.com
) - User Authorization Callback URL: Set to
[your-coder-domain]/oauth/callback
(e.g.https://coder.domain.com/oauth/callback
)
GitLab
When setting up OAuth with GitLab, you'll have to provide the following during setup:
- Redirect URI: Set to
[your-coder-domain]/oauth/callback
(e.g.https://coder.domain.com/oauth/callback
)
You can modify the settings for your application afterward. Make sure you've enabled the following:
- Confidential: Check this option
- API (scope): Check this option
Bitbucket Server
On your Bitbucket Server, go to Administration > Application Links.
Create a new Application Link, setting the Application URL as [your-coder-domain]
(e.g. https://coder.domain.com
). If you receive a No response received error, click Continue to ignore it.
For your newly created Application Link, provide the following values as your Incoming Authentication properties:
- Consumer Key:
Coder
- Consumer Name:
Coder
- Public Key: Your public key (available from the Coder Admin Configuration
page)
When done, click Save.
Comments
0 comments
Please sign in to leave a comment.