GitLab self-managed instance as a source for your API definitions and developer portal projects.
GitLab self-managed operates similarly to the GitLab.com integration. It requires some additional setup.
Navigate to your GitLab user settings. Create a GitLab Application.
A regular user account is acceptable, but we recommend you create a service account for managing applications. Service accounts typically have administrative privileges, and are not used by human users, but by the system for administration and interacting with external services.
Go to the Applications tab and provide "Redocly Workflows" for the new application name.
Set the Redirect URI to
Activate the api scope from the Scopes list in order to allow our system to read your repositories and write commit statuses.
Select the Save application button to create a new application.
You will be redirected to the page with credentials for the new application.
Keep this tab opened (this data is required for the following steps).
Navigate to your Org Settings and go to the Source control providers tab.
Scroll down to GitLab self-managed section and copy/paste Application ID and Secret values from the GitLab application to the corresponding form fields. Also, provide the URL to your self-managed instance.
Select Save self-managed Gitlab settings to complete the configuration.
You're all set! You can now use the GitLab self-managed source similarly to the GitLab.com integration source.