docs: Document git_hosting_providers for self-hosted Git instances (#43278)

Closes #38433

Document how to register self-hosted GitHub/GitLab/Bitbucket instances
via git_hosting_providers setting so permalinks and issue links resolve.

Release Notes:

- Added documentation on how to register self-hosted
GitHub/GitLab/Bitbucket instances via the `git_hosting_providers`
setting. This ensures permalinks and issue links can be resolved for
these instances.
This commit is contained in:
Oscar Villavicencio
2025-11-24 11:32:44 +01:00
committed by GitHub
parent 4b04be6020
commit d333535e76
2 changed files with 42 additions and 0 deletions
+28
View File
@@ -4693,6 +4693,34 @@ See the [debugger page](./debugger.md) for more information about debugging supp
- `collapse_untracked_diff`: Whether to collapse untracked files in the diff panel
- `scrollbar`: When to show the scrollbar in the git panel
## Git Hosting Providers
- Description: Register self-hosted GitHub, GitLab, or Bitbucket instances so commit hashes, issue references, and permalinks resolve to the right host.
- Setting: `git_hosting_providers`
- Default: `[]`
**Options**
Each entry accepts:
- `provider`: One of `github`, `gitlab`, or `bitbucket`
- `name`: Display name for the instance
- `base_url`: Base URL, e.g. `https://git.example.corp`
You can define these in user or project settings; project settings are merged on top of user settings.
```json [settings]
{
"git_hosting_providers": [
{
"provider": "github",
"name": "BigCorp GitHub",
"base_url": "https://git.example.corp"
}
]
}
```
## Outline Panel
- Description: Customize outline Panel