Integrations
Connect your organization's providers and your personal accounts so CodeLantern can work with your issues and source.
An integration connects your organization to a provider. Admins manage these connections from Integrations in the portal. Each member also connects their own account so CodeLantern can act on their behalf.
Provider roles
A provider can perform one or both of these jobs:
- Project management (PM): issues, backlog, and the board you plan against.
- Source control (SCM): code, branches, commits, and pull requests.
| Provider | Project management | Source control |
|---|---|---|
| GitHub | GitHub Issues and Projects | GitHub repositories |
| Azure DevOps Services | Azure Boards | Azure Repos |
| Linear | Linear issues | No |
| Jira Cloud | Jira issues | No |
Choose the providers for each repository in Repositories. Linear and Jira need GitHub or Azure Repos for source control. GitHub project management requires a GitHub-hosted repository.
Organization connections
GitHub
Choose Connect GitHub on the Integrations page and authorize the CodeLantern GitHub App. Give the app access to the repositories your team will use. GitHub can provide both project management and source control.
If a repository is missing from CodeLantern, check that the app installation has access to it and belongs to the expected GitHub account or organization.
Azure DevOps
Connect an Azure DevOps Services organization from the Integrations page and authorize through your Microsoft account. One connection can be used across projects in that Azure DevOps organization. Azure Boards and Azure Repos can use different projects.
For automatic issue-metadata updates, the account registering the connection for an Azure Boards project needs Project Administrator permission on that project. If this permission is missing, CodeLantern reports a warning. Repository operations remain available, but continuous metadata updates are unavailable until the required permission is granted and setup succeeds.
Azure Boards uses tags where other providers use labels. Tags have names without colors or descriptions, and names cannot contain ; or ,.
Linear and Jira Cloud
Choose Connect Linear or Connect Jira and authorize access to your workspace or site. Use the connection for project management alongside GitHub or Azure Repos for source control.
Personal connections
Signing in to CodeLantern and joining an organization do not complete provider authorization.
- Select the organization you will work in.
- Open Personal settings → Connected accounts.
- Connect the accounts shown for that organization's providers.
- Return to the portal and confirm that each required account shows Connected.
Personal connections belong to the selected organization. If you work in more than one CodeLantern organization, check your connections in each one. An organization admin's connection does not replace yours.
Connection problems
- Setup required or authorization expired: connect or reconnect your personal account. If the organization integration is disconnected, ask an admin to reconnect it on the Integrations page.
- Access denied after connecting: check your permissions in the provider. Reconnecting cannot grant access to a project or repository you are not allowed to use.
- Wrong account: authorize with the intended provider identity and follow any identity-mismatch message in the portal.
- Provider missing from Connected accounts: ask an admin to check the organization's integration first.
If a repository still needs configuration after reconnecting, follow repository recovery.