Change GitLab domain

Prerequisites

  • GitLab server
  • Desired GitLab domain (e.g. git.company.com)
  • DNS A record with the IPv4 address of the GitLab server as the destination
  • DNS AAAA record with the IPv6 address of the GitLab server as the destination


Change GitLab domain

To customize the GitLab domain, log in to the creoline Customer Center and navigate to the GitLab server for which you want to customize the GitLab domain. Select the Configuration files tab and then click Edit.


To navigate more quickly when editing large configuration files, you can also use Ctrl + F (Windows) or Command + F (MacOs) to search for a specific term or similar within the configuration file.



Enter the desired new GitLab URL in the external_url area.


Example:

external_url "http://git.company.com"


Make sure that the desired URL contains the required A and AAAA entries before you save the changes, otherwise a valid Let's Encrypt certificate cannot be issued for the new GitLab URL.


Then enter a short message in the Change message area explaining why the GitLab URL was changed and save the changes using the Save changes button.


Saving the configuration automatically triggers the deployment of the configuration and the subsequent restart of GitLab. Inform active users about the planned action in advance.



Official GitLab documentation:

https://docs.gitlab.com/omnibus/settings/configuration.html#configure-the-external-url-for-gitlab



GitLab Managed Hosting
Similar articles
On this page
Emergency?
In urgent cases, our emergency hotline is available around the clock at +49 2507 900 80 - 34.