Configure GitLab Integration

Note: This information applies to SwaggerHub On-Premise.

SwaggerHub’s integration with GitLab (GitLab Sync) supports both GitLab.com and self-hosted GitLab servers. The target GitLab server is specified in the integration settings and can be changed by the users. However, you can change the default GitLab server for integration in your SwaggerHub On-Premise system configuration.

Changing the default GitLab server for integration

GitLab.com

SwaggerHub is pre-configured for use with GitLab.com, so you can start using GitLab Sync right away.

GitLab Community and Enterprise

To specify your self-hosted GitLab server as the default server for integration:

  1. Open the Admin Center.

  2. Select Settings > Integrations on the left.

  3. In the GitLab Server URL field (or GitLab API URL in earlier versions), enter the URL of your GitLab server, for example, https://gitlab.MyCompany.com. Make sure to include http:// or https:// at the beginning.

  4. Click Save Changes and Restart.

    In v. 1.19.1 or earlier, click Save Changes, then switch to the System page and click Restart SwaggerHub.

  5. Wait a few minutes for the system to restart completely.

GitLab Sync integration will now default to your self-hosted GitLab server. Note that the users can still specify a different GitLab server in the integration settings.

See Also

Publication date: